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How random is RND? An analysis of the C64 and CI 28 RND routines 
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ThunderBear by Wayne Schmidi 
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No other training — in school, on the job, 
anywhere — shows you how to trouble- 
shoot and service computers like NRI 



HUD DISK 

imemairv for gre3ter oata storage 
capadtv ana cQta access soeetL 



PACKARD BELL COMPUTER 

NEC V40 duaJ ^peed id 77 MHZ/8 MW CPU. 
51 ZK EiAM. 3eoh doubi^-fUfted d^k drive. 



DKITAL MULTIMETER 

Professional test Instnjment for 
QukK and easy measurements. 



MONITOR 

HJgh-resoluTlor. non-glare, 1?' TTi 
monocnrome monitor wtth tut and 
swivel Dase. 



TECHNICAL MANUALS 

wim prcFfessionai pftjgrams and 
complete spec5 on Pacwartl 
Bell computer. 



LESSONS 

Oearcut. iiiustrBteO 
meri r>ulid your 
undef^tandlng 
of computers 
step bv step. 



SOFTWARE 



including MS-DOS CW 
BASIC, word processing. 
Osxaoase and spreadsheet 
pnigrams. 




DISCOVERY LAB 

complete preadOoarOlng 

svstem to let you design and 
modtfv circuits diagnose 
and repair fautts- 



maTAL 

LOGIC 

PROBE 

simplifies 
analyzing digital 
circuit operation. 



Only NRI walks you through the 
step-by-step assembly of a powerfut 
XT'CompatibJe computer system you 
keep— giving you the hands-on 
experience you need to wor1( with, 
troubleshool, and service all of today's most 
widely used computer systems. You get all it 
taifes to start a money-making career, even a 
business of your own in computer service. 

No diiubi about it: The bcsr way to learn to scnicc computtTS is to acimUy 
fmikt a Jl(ate^>f'lhC'afl t<nnput(T fmm the ke>'biiard i*n iip \s y<Hi pui ihe 
[rachine togerher, perl^imiinp key icsts and dcmunsiraiKtns ai racti ^[iipt nf 
assembK y<m Kf ((*r y*nirse\t how cadi pan of ii works, whaJ tiin go ^ning. 
and how you cjn Hx U, 

Only NRI— the kodcr in cartCT-buiWing. at-homc dccminics triining hw "'5 
years— ^vo nm such praakat, ivaJ-wcifId ci»mpu[tT scrvicinntj^ticnii:. Indeed, 
no oihtT [raifiinR— in school, on ihc job, wiyubcrv— fjH>ws you him' hi iruubt- 
^houi and senicc curapuicrs Like NKI, 

You get iodemand computer servicing skills as you 

train with your own XT-compatible system— now 

with 20 meg hard drive 

With NRI'^ exchsLve haniiHm truninp, vou actuaflv build and keep Ihe pf>WTriij] 
new Padard Bell \'XKH IHTXi cnnipiibt t'ompurtT. tompleie wuh tI JK R,\,M and 
21) nk:g hjnl disk tlri\^. 

You sun b\ JS'rfTiibUnp jnd rtAiinf; rhr "inTtHimTir" kc^iicjord, miAf on lo tot 
Iht- LTft'uiirv t>n ibtntiin l<i^c' board. iittuJl itn: piiwtT siqiply and^'/t" dtsk drive, 
ihtii imcrfAc Miurhi^i-rcvrluuim n^imiror tlul dul's ihil^ 

Only NRt gives you a top-rated micro with complete 
training built into the assembly pfocess 

Your \R1 handMin irjining ciinunui.?» as you in>till Ihc ptmcrful ,30 niq^ahMt hard 
disk dri\f— ujdj\ S rrnftj wunicd tonipoicT pcriphcnl— intliiUcd iii yijur 1.1H1™: to 
druiutHraih iix.n.-'iu' youf tcmpuicr s storage L^patiry whik' ^1^mg vihi b^cning- 
quKk dau acc^ess. 

Having full \ av*mhk-d\ our Piitkard Bell \'\SM \im lateiiihmi^acomplcU' 
series of diajtnostic resis. ma^ifLTinp pmlesskmal ciimpurcr <r^ rdriR nrcluiiques as you 
take command ol Ihe full power of ihc \'XHH'8 highspceil V4(Jmii"Toptrx:cssor 

In no lime ar all, you ha\'e The tonfidmce and (he knon how to work with. 
Irodtehoi>i. and seniccotry compuiiT imtbc markd todiy iiRkx'd vihj have 
whai It lakw 10 step into a fuU-tunc, mimcy-nukinR career as an industry iccbnimin. 
o'oi ^t3^ ji.ompuitTScr\itcbuj*incs&of >ourown. 

No experience needed, NRI builds it in 

You need mi ptciiixis exprnentt' in compuiers or electronics to wjccccd with NRI. 
You Ran with Ihe basio, foIk^uir^easT -to-read instnK dons and diagruiti, quickly 



mo\ii^ from the Hindamcntab 10 
iophisiiraied compuitr ?ifn iting 
itthniques Sap by cdsy sitp. you 
^ iht kuxl of practkral hands-on 
nqxnfTKT ihai makts yiiu tiniqucty 
linpared n 1 takv ad\'ania^- iif cvti*)' 
opportunity in today's lup-growth 
field of c(xnpu[tTser\ice 

tt'hat's more— vou leam M xour o^^-n 

n r 

pate in \o\ir own honur. No Llassroom 
pressures, no ni^i school, no need to 
quit your prewiii |oh untii \ou'n: ready 
to maice your mo\c And all ihroujdioui 
your rraining, you have the loll support ol yi)ur pcrv>nal NRI insiructor anU ihc NRI 
technical stafi always ready to aaswcr your questions 2nd give you help s^henc^ cr 
you need il 

Your FREE NRI catalog tells more 

Send today lor ) our free tull-toh ti caialon dotnhm^ ti in a^pixt of Mil's uuiovauvc 
computer training, an ^tU j> h.iikLMin training in n'l^itn.s. xideo/ aiKlio servicing, 
dccttDnic mustc leehnoloji^ . sc^umy ekxnronicN, daiacooiniunitaiiuTLs, andiHlicr 
gn>winji high [n li K'jnx-t fK-ltfc^, 

If the coupon is mis.sing. write 10 VRI Schodrf Elearonies. MdinwHill 
Coniinuii^ Education Center. 4 »tH Conrnxticul Avenue, \tishii^non, DC 2000B- 
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Transactor 

The Magozine for Commodore Programmers 



Inside GEOS 128 

by William Coleman 

Ai lasi! Read it here first! Wbaiyou need jo know (o progrjini GEOS on Ihc I2S. 



29 



Loadermaker 

by Nicholas J. Vrtis 

IJcvelopJng a GEOS program in ihe standard environment? This program eliminates conversion. 
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An Introduction To GEOS files 

by Francis G, Kostella 

A handy Icon Dc finer program thai demonstrates the use of the high-level disk mutines. 
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RAMifications 

by Richard Curcio 

Some suggestions for fattening the C 1 2R, 
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How Random is RND? 

by D. J. Morris 

The C64/CI28 RND routines: The orderly generation of disorder includes some surprises... 

Turning Off Write/Verify 

by Dennis.J. Jai^is 

The inner workings of the 157rs vectored operating system. Includes a BASIC program that will run 
on all 8-bii Commodore ^^ompuicrs. 
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Make 2 Sided 58 

by DennisJ. Jarvis 

Convening 1541 disks to 1571 formal - ou could do it by hand but this pn^ram makes ii simple. 



Customizing C128 CP/M 62 

by Miklos Garamszeghy 

Patching the CPM+.SYS program. 
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by Todd Heimarck 

Ever wondered haw daia compression wori(s? Todd explains ihc ins and ouis of Huffman encoding and 
crunches a veree from A. A. Milne. 



The Edge Connection 22 

by Joel Rubin 

Joel shares his experiences with a 1700 RAM expansion unil. There's much more capability in Ihai 
I28K than you mighi have thought. And the price is righl-„ 



Reviews 

What's Really Inside the Commodore 64? 

Jim Buliedleld analyzes this commenled disassembly 

Macro Set 1 

Reduce program development time with ihis handy package from Xytcc 

SFX Sound Expander 

Comnuxlorc UK's hardware add-on is now making beautiful music in North America 

X-10 Powerhouse Computer Interface 

Wiih an X-10. you can control the worlds, oral least your house. 
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About the cover: Tht/fuferBcar was created by Wayne Schmidt using Kuikptiiut and 
Artist 64. Wayne describes the picture a> follows: 

"Inspired by KwakiutI motifs (North West Coast Indians), the subject is a 
'transformalion' mask design worn by shamans during initiation and ceremonial events. 
During: these events, ihe Thunderbird outer mask opens to reveal a great Bear spirit." 
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Using "VERIFIZER" 



Transactor's foolproof program entry method 



Verifizer should be run before lyping in any long program 
from ihe pages of Tmnsaaor. U will lei you check your work 
line by line a_s you enter ihe program and caicli frustrating typ- 
ing errors. The VERIFIZHR concept works by displaying a two- 
letter code for each program line: you can then check this code 
against the corresponding one in the printed program listing. 

There arc three versions of VERIFIZER here: one each for the 
PET/CBM, VlC/CM, and C128 compters. Enter the applica- 
ble program and KL'N n. 11 you gel a data or checksum error, 
re-check the program and keep trying until all goes well You 
should SAVE ihe program since you'll want to use it every 
time you enter a program from Transactor. Once you've RUN 
the loader, remember to enier NEW to purge BASIC teKC 
space. Then turn verifizer on with: 

SYS 634 to enable the PET/CBM version (off: SYS 637) 
SYS 828 to enable the C64/V1C version (off: SYS 831 ) 
SYS 3072J to enable ihe C128 version (off: SYS 3072,0) 

Once VERIFIZER is on. every time you press RETURN on a 
program line a two-letter report code will appear on the top 
left of the screen in reverse field. Note that these letters arc in 
uppercase and will appear as graphics characters unless you 
arc in upper/lowercase mode (press shift/Commodore on 
C64/V1C). 

Note: Tf a report code is mfssing for "-") it means we've 
edited that line at the last minute, changing the report code. 
However, this will only happen occasionally and usually only 
on REM statements. 

With VERIFIZER on. just enter the program from the m^azine 
normally, checking each report code after you press RETUEW 
on a line. If the code doesn't match up with the letters primed 
in the box beside the listing, you can re-chcck and correct the 
line, then try again. If^ou wish, you can LIST a range of lines, 
then type RETURN over each in succession while checking 
the report codes as they appear. Once the progium has been 
properly entered, be sure lo turn verifizer off with the SYS 
indicated above before you do anything else. 

VERIFIZER will cateh transposition errors like POKE 52381,0 
instead of POKE 53281,0. However. VERiFiZER uses a 



LL 



weighted chefksum technique" that can be fooled if you try 
hard enough: transposing two sets of four characters will pro- 
duce the same report code, but this will rarely happen, (verj- 
F17F.R could have been designed lo be more complex, but the 
report codes would need [o be longer, and using ii would be 
more trouble than checking the program manuidly). VERIFIZER 
ignores spaces so you may add or omit spaces from the listed 
program al will (providing you don't split up keywords!) Stan- 
dard keyword abbreviations (like nE instead of next) will not 
affeci Ihe verifizer report code. 

Technical info: VIC/C64 verifizer resides in the cassette 
buffer, so if you're using a dalaselle be aware that tape opera- 
tions can be dangerous to its health. As far as compatibility 
with other utilities goes, verifizer shouldn't cause any prob- 
lems since it works through the BASIC wann-slari link and 
jumps to the original destination of the link after it's finished. 
When disabled, it restores Ihe link to its original contents. 

PE I/CBM VKRIFIZER (BASIC 2.0 or 4.0) 



CI 10 rem* data loader for "verifizer 4.0" * 

LI 20cs=0 

HC 30 for i=634 to 754: read a; poke i.a 

DH 40 cs=cs+a: next i 

GK 50; 

OG 60 if cso 15580 then print"***** data error **** 
JO 70 rem sys 634 
AF 80 end 
IN 100: 

ON lOOOdaia 76.138. 2.120.173.163. 2,133. 
IB 1010datal73, 164. 2.133.145. 88. 96.120. 
CK I020dala 145.201. 2.240. 16,141.164. 2. 
EB 1030 data 144, 141, 163, 2. 169. 165. 133, 144, 
HE 1040data 2.133.145. 88. 96. 85.228.165. 
OI I0.50data201. 13.208. 62.165.167.208. 58, 
JB 1060data254. I. 133.251, 162, 0. 134,253. 
PA I070data 0. 2.168.201. 32.240. 15.230. 
HE 1080data 165.253, 41, 3.133.254. 32.236, 
EL 109O data 198.254. 16.249.232.152.208.229. 
LA Il00dala251. 41. 15, 24.105.193,141. 0. 
KI lllOdata 165,251, 74. 74. 74. 74. 24.105. 
EB Il20dalal41. 1.128.108.163. 2.152. 24, 
DM 1130daia25l, 133.251. 96 



*". 



: end 



144 
165 
165 
169 
217 
173 
189 

253 
2 
165 
128 
193 
101 
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VIC/C64 VERIFIZER 

KE 10 rem* data loader for "verifl/er" * 

JF 15 rem vic/M version 

LI 20 cs=0 

BE ,10 for i^828 to 9?i8:read a:poke i,a 

DH 40 cs=cs+a:nex( i 

GK 50: 

FH 60 if CS014755 then print"***** data error ***•*": end 

KP 70remsys828 

AF 80 end 

IN 100: 

EC 1000 daia 76. 74. 

EP lOH) data 252. 141. 

OC 1020 dala 3.240. 

MN 10.M)daia25l. 164. 



3,165.251, 141. 2, 

3. 3. 96, 173. 3. 

17,133,252,173, 2, 

99, 141. 2, 3, 169. 



3, 
3. 
3, 
3. 

MG 1040 dala 3. 3, 96,173,254, 1,133, 89. 
DM 1050 dala 0,160. 0,189. 0, 2.240, 22, 
CA 1060daia 32,240, 15,133, 91,200,152, 41, 
NG 1070 daia 133. 90, 32,183, 3,198. 90, 16. 
OK lOSO dam 232. 208, 229, 56. 32,240,255,169, 
AN I090daia 32.210,255.169, 18, 32,210.255, 
GH linodaia 89, 41. 15, 24,105. 97, 32,210. 
JC 1 1 10 data 165, 89, 74, 74, 74, 74. 24J05, 
EP mOdata 32,210,255,169,146, 32,210.255, 
MH 11 30 dam 32.240,255,108,251. 0,165, 91, 
Bll i 140 data 101, 89,133, 89, 96 



165 

201 

133 

141 

162 

201 

3 

249 

19 

165 

255 

97 

24 

24 



*NEW* CI28 VERIFIZER (40 or 80 column mode) 



KL 100 
Ol 110 
MO 120 

DC 130 



KK 

GH 

HG 

IF 

DG 

EB 

GC 

NK 

BL 

DP 

AP 



I4t) 
150 
160 
170 
180 
190 
200 
210 
220 
230 
240 



BA 250 
MM 260 
AA 270 
FM 280 
IF 290 



FA 
LC 

AJ 

EC 

PI 

FF 

DE 



300 
310 
320 
330 
340 
350 
360 



remsave"0:cl28vfzJdr",8 

rem c- 1 28 veritlzer 

rem bugs fixed: 1 ) works in 80 column mode, 

rem 2) sys 3072.0 now works, 

rem 

remby joel m. rubin 

rem * da(a loader for "verifizer c 1 28" 

rem * commodore cl2S version 

rem * works in 40 or 80 column model!! 

ch=0 

for j=3072 lo 3220: read x: poke j,x: ch=ch+x: next 

if cho 18602 ihenpriiii "checksum error": stop 

print "sys 3072,1 to enable 

print "sys 3072.0 to disable 

end 

data 170,208, 1 1, 165. 253 J4!, 2, 3 

data 165. 254, 141, 3, 3, 96, 173, 3 

dala 3,201. 12,240. 17,133.254.173 

data 2, 3, 133.253. 169. 39, 141. 2 

data 3, 169^ 12, 141, 3, 3, 96, 169 

data 0.141. 0.255,165, 22,133.250 

dala 162, 0, 160. 0, 189. 0, 2, 201 

data 48,144. 7.201, 58,176, 3,232 

data 208. 242, 189, 0, 2,240, 22.201 

data 32,240, 15.133,252,200.152, 41 

data 3.133-251. 32,141, 12,198,251 

data 16,249,232,208,229, 56, 32.240 



CB 370 daia 255, 169, 19, 32.210.255.169. 18 

OK 380 data 32,210,255,165.250. 41, 15. 24 

ON 390 data 105, 193. 32,210,255,165.250. 74 
Ol 400data 74, 74. 74. 24,105,193. 32.210 

OD 410 data 255, 169. 146. 32.210,255, 24, 32 

PA 420data240, 255. 108,253, 0,165.252. 24 
BO 430 data 101,250. 133,250. 96 



The Standard Transactor 
Program Generator 

If you lype in programs from the magazine, you mighl be able 
to save yourself some work with the program listed on this 
page. Since many programs are primed in Ihe form of a BA- 
SIC ^'program generator" which creates a machine language 
(or BASIC) program on disk, we have created a "standard 
generator" program that contains code common to all program 
generators. Just type this in once, and save all that typing for 
every other program generator you enter! 

Oice the progr:im is typed in (check the Verifizer codes as 
usual when entering it), save il on a disk for future use. When- 
ever you lype in a program generator. Ihe listing will refer lo 
Ihe standard generator. Load the standard generator _/jr5/, then 
type the lines from the listing as shown. The resulting program 
will include the generator code and be ready to run. 

When you run the new generator, it will create a program on 
disk (the one described in the related article). The generator 
program is just an easy way for you to put a machine language 
program on disk, using the standard basic editor at your dis- 
posal. After the file has been created, the generator is no 
longer needed. The standard generator however, should be 
kept handy for future program generators. 

The standard generator listed here will appear in every issue 
from now on (when necessary) as a standard Transarror utility 
like Verifizer. 



rem transactor standard program generator 

nS='Tilename": rem name of program 

nd^OOO: sa=00000: ch=00O00 

for i=l lo nd: read x 

ch=ch-x: next 

if ch then print "data error": stop 

print "data ok, now creating file." 

restore 

open l,8,K"0:"+n$ 

hi=int(sa/256): lo=sa-256*hi 

prinl#LchrS(lo)chr$(lii); 

for i=l lond; read x 

prini#I.chr$(x);: next 

close I 

prinT"prg file *";n$;'" created,.." 

prini"ihis generator no longer needed," 

□ 



MG 


100 


EE 


110 


LK 


120 


KO 


130 


EC 


140 


FB 


150 


DE 


160 


CM 170 


CH 


180 


HM 


190 


NA 


2[HI 


KD 


210 


HE 


220 


JL 


230 


MP 


240 


MH 250 


IH 


260 



w 



Transoctor 



ApHI 1969: Votunm 9. Issue 4 



Follow-ups and returns 



Last issue this space vvas devoted to copy- 
proteclion. Specifically, I was upsel thai Com- 
modore GEOS is protected and Apple GEOS isn't. 
Since that lime I have discovered a very interesting 
thing: When first released, Apple GEOS was copy- 
proicclcd but the response from the Apple commu- 
nity was so negative that Berkeley Soflworks re- 
moved the protection ! Since then, Apple GEOS 
sales figures have improved. Of course, some may 
contend that sales were stimulated primarily by the 
release of Apple GeoPuhfisli. but my own feeling is 
that sales of both are augmented because of the ab- 
sence of copy-protection. 

This means there is hope! Write to Berkeley and tell 
them how you feeL Maybe we can get the situation 
changed. In the case of Apple GEOS. Berkeley Soft- 
works has demonstrated that they are responsive to 
the user community. The ball is in your court now... 

The response to Paul Bosacki's hardware project m 
9;2 has been phenomenal. Seems hke everybody 
wants more RAM! A sampling of the letters Paul 
has received (and PauPs replies) have been included 
in Letwrs. Also in t^jis issue is an article by Richard 
Curcio suggesting a similar project for the CI 28. In- 
cluded with that are the letters between Paul and 
Richard and some schematics from Richard. This is 
a topic that is not going to go away! Now if only the 
price of RAM would comedown,,. 



In 9:3 we were pushing the limits' with George 
Hug's Toward 2400: another article that was very 
well received. I don't know how many people have 
called about that. Some of them called to get the 
missing data statement line from the CIA test pro- 
gram (see Bloops), Some were interested in incor- 
porating the routines in their own programs. At least 
the prices on 2400 bps modems have become af- 
fordable... 

We're pushing the limits in 'fleshware' too. By the 
time you read this the Transactor editorial staff will 
be 33% larger. That's right, we have a new editor. 
Tim Grantham did eight Amiga Dispatches columns 
for us before Don Curtis started doing it when we 
started up TransAmi. Tim also recently started a 
new column in TransAmi called Hard Copy. Tim 
has been "in deep' for quite a while with both the 
Amiga and the 8-bit machines. We're very pleased 
to welcome Tim back to Transactor. The extra man- 
power means weMl have time for other things, such 
as eating, sleeping and breathing. 

Also reluming this issue are Letters and NewsBRK. 
To those of you who wrote in about it or were Just 
wondering, they haven't been discontinued. We Just 
needed the space. Both departments are fairly 
weighty this time. 

Malcolm D. O'Brien 
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Pleuic address letters to the editor to: 
Letters. Transactor Magazine. 
I0-^S5WeM\Mhftot Street, 
Richmond Hill. Ontario L4B IK7. 

A tak uf Mue— and a suLution: I would 

like to thank you all for the complimen- 
lary copy ol" Jrumacior coniaining Joel 
M. Rubin\ comparison review of a few 
Commodore macro assemblers; my Bud- 
d\' included, Brian Hilchic once said lo 
me. regarding a not so lolally positive 
review of his C compiler, "Bad publicity 
is beticr than no publicity." Of course it 
wasn't a bad review, or unfair. Bui it still 
pissed mc off and made me say some 
gosh dam bad words. 

But before I launch into anv more heart- 
rending whining or the reason why 1 felt 
compelled to say these bad words* I 
would like lo share a glimpse of ihe soft- 
ware industry through the eyes of Bnd- 
dy's greatest fan and victim: its author; 
the idea being not only to egoize on a 
bit. but to try and piece together an ad- 
mitiedly cynical software publication 
theory lo be considered by olher users 
and hackers pure in spirit, 

Lvery hacker has dreams (in addition to 
ihose of flying and being found inexpli- 
cably and embarrassingly naked in pul> 
lie places) of gaining recognition and re- 
ward for his awesome programming ac- 
complishments. I (excepi for the flying 
dreams) am no different. 



Before Buddy. 1 did a screen design and 
animation utility for games program- 
mers called 04 Anintator. Ahhough life 
on Earth *and perhaps my marriage) 
could well have carried on much Ihe 
same if I had not> it wasn't bad, and ev- 
ery publisher that ever looked at it drew 
up a contract. Except Commodore. 
Commodore looked at it for about six 
months and then said they weren't in the 
software business anymore. I do believe 
however that some of ihe ideas in ii mav 
have found their way into the sprite rou- 
tines on the 128. (Call me paranoid; call 
me a megalomaniac; just don't caJl me a 
lawyer.) Commodore f Canada) relumed 
the sixty bucks I had put up lo get ihem 
lo look at it in the first place: thereby, in 
(heir expressed consideration, voiding 
our non-disclosure agreement 

Richvale Telecommunications (reniCTnber 
Script 641) signed up for Animator next - 
then sat on it tor about six months until 
they went under. Next it was Pro-Line's 
turn. Pro-line dinkcd around with it liter- 
ally for years before releasing it lo Spin- 
naker who released it back to them who 
released it back to me. Richard Evers' 
Northern Blue Marketing Inc. contracted 
lo publish it next, and is currently doing 
SO- and - get this - has actually sent mc a 
royalty cheque, Richard and company 
and family, I love you; 1 really do. 

Buddx assembler was Pro-Line's idea. 

r 

The world owes BaJdy to Pro-Line and 



OSAP tOntario Student Assistance Pro- 
gram). I even made almost enough mon- 
ey the first year to, say, cover my hydro 
(1 heat with oil). StilL it was better than 
the nolhing I was accustomed to. Then 
Pro-Line decided to sign an agreement 
for all of their products with the btg 
boys at Spinnaker down in Boston. And 
that was that. The first quarter ! actually 
earned a negative royalty. Of course, 
they didn't make me pay; they let me 
owe it lo them. Next quarter I paid Pro- 
Line back from royalties based on back 
collections from their own sales and I 
haven't seen a nickel since. And neither 
has Pro-Line from what I hear 

Anyone who bought Spinnaker's pack- 
age (nobody according lo my perceni- 
age) probably wondered why the name 
Power Assenihier is displayed above C 
source code. After all, the assembler 
says "Buddy" when you run it; you 
have to type in "Bud" to invoke it; the 
manual refers to the "Buddy System" 
throughout: and C source would surely 
be a wonderlul source * of syntax errors. 
But I would be willing to let ihem slide 
for seemingly sticking it in a used box: 1 
would even be willing to ignore the fact 
ihai ihey have never advertised the prod- 
uct - if it were not for the following: 

Spinnaker apparently does not believe in 
updating their releases. The version re- 
viewed is as old as the proverbial hills. 
Buddy has been a true macro assembler 
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for years; it ha^ a vertical split-screen 
editor, superior memory managcmcLit, 
speed, and display fonmarting. and even 
improved documcnlalion (ahhouiili 
some might suU find it overly concise). 
Jim ButlerfieJd. Liz DeaJ. Richard Ev- 
ers, Miklos Cariiniszcghy. Danen 
Spruyi. John Lem and a zillion oihen; 
gave mc valuable feedback in bringing 
Buddy up lo what is currently not 
available from Spinnaker today. Now, I 
know liiul hackers update their stuff 
hourly and a publisher can't always be 
resmffing boxes, but Spinnaker has had 
Ihe latest and greatest for over a year. 

Just sitting there. 

Now, ril probably never gel rich off 
Buddy, but it does give me a nice, warm, 
fuzzy feeling to know that someone out 
there is occasionally wowed by it and 
finds Ji useful. And it annoys the socks 
off me when gianis sleep in the road. 

I guess my advice to hackers in search 
of recognition and reward would be to 
seek out the smallest publisher you can 
find- Software publishers are like fish: 
die bigger ihey arc. ihe harder they jerk 
you around- This is my theory: it is what 
1 have come lo believe. 

Transactor has been my staunche^t ally 
ali along; always connecting me with the 
right people and the right infomialion. 
Ever catering to my ever-starving ego. 
You guys saved my life. [ cannot thank 
you enough. 

I now spend my days coding medical 
systems in C on Kitchener Online Data's 
style of the an, 32-nodc, QNX network. 

1 enjoy the work and the people. But the 
Commodore 64 was my first and is my 
deepest love- I feel bad for letting her 
languish sometimes, because if it were 
not for the Commodore 64 and Transac- 
tor I honestly believe that I would still 
be painting lownhouses or washing pots 
for a living - instead of playing on the 
virtual circuits- All the best. 

r 

Chris Miller 

2 Hilda Place, Kitchener. ON N2G 1 K3 

As you can see. this is not your arerage 
letter to the editor. Since it contains 
some provocative material, f plumed 



Chris to ask him rf he would mind if we 
printed it. He said that he had \rritten it 
figuring that we woidd publish at least 
stmie of it. Of course, the statements 
made and opinions expressed are Chris' 
own. Transactor received a letter and 
published it. that^s all. 

Since his main concern at this point, as 
expressed in the letter, is the un- 
availahiliiy of his upgrade. I made a 
suggestion and Chris agreed to it. I sug- 
gested that Chris sitpply the upgrade di- 
rectly. Chris was concerned that u.ters 
wouid think that he was just trying to 
scoop up some cash by writing his letter 
/ told him that I would say that the up- 
grade offer was my idea {and so it was). 
He also didn't want to charge so much 
that people would he put off and he de- 
nied the upgrade. We agreed that $10 
was a reasottahle figure and unlikely to 
dissuade anyone on the ha.sis of cost. 

Of course, the rights to Buddy are held 
hy Spinnaker and he can't he taking cus- 
tomers from them. So.., if you send your 
original Power Assemhier disk and $10 
to the address piuitcd above. Chris will 
send ytnt the "latest and ^^reatesi" ver- 
sion of Buddy with some supplcmemary 
docs on disk. I stress that it must be the 
original dfik. This way. Chris is not tak- 
ing customers from Spinnaker. They 
make their money when you purchase 
Fower Assembler, in effect, Chris is pro- 
viding custfimer support for their prod- 
uct on "volunteer plus costs pli4s a lit- 
tle'^ basis. Since the product is not copy- 
protected, you won't have to do without 
while it's in the mail. 

Pushing the Limits: Paul Bosacki's ar- 
ticle on expanding the C64's memory in- 
ternally has been very well received, lo 
put it mildly. Paul has received numer- 
ous letters and is still receiving ihem 
(and replying lo UiemJ as wc go lo press. 
In the space remaining we\'e included 
some ol iIicsl: letters along with PauPs 
responses. I've edited both the letters 
and responses somewhat lo eliminate 
material which docs not peilain direcUy 
to iheanicle. - MO 

Wanted: Non-volatile 1750: 1 read vour 
article, "Care and hcedmg ot the C256'* 
in Transactor 9:2 with great interest. Tm 



writing you in the hope that you may 
have an answer to a possible hardware 
fix for the 1750 REU. I use it as a CP/M 
RAMdisk on the C128. Pm told thai it 
might be possible to convert the REU 
into a non-volatile RAMdisk. This ap- 
parently could be done by interrupting 
the power supply line from the main 
board inside the cartridge, insening a 
"refresher circuit" (oscillator/regulator) 
and connecting this circuit to a direct 
and constant power supply. 

Not a battery; used, for instance, by the 
Quick Brown Box. Since the REU uses 
dynamic and not static RAM. a battery 
wouldn't keep its charge very long, sus- 
taining 512K of DRAM. But rather con- 
necting the cirLuil to a transfonncr plug, 
of the kind used lo power transistor ra- 
dios when iheir batteries aren't being 
used. It was suggested that a plug sup- 
plying 7 volts would be about right- 
Does it seem to you that this would be 
possible? If so. I'm not sure Vd aliempi 
ii myself, but with the proper instruc- 
tions and a rough schematic, if needed, 
Pd happily hand it over to an experi- 
enced technician. 

Carl Gabler, Van Nuys. CA 

And I'm afraid that all I have is had 
tiewsfor you. i ttm. have heard of such a 
hardware fix, bat only in the "wouldn V it 
he ^reat if stages. When I first recetved 
your letter. 1 looked briefly into the prob- 
lem, and though I believe it possible. I 
just haven't had the time to do anything 
about it. Your note outlined the problem 
exactly: external jwwer supply, voltage 
regulator and a refresher of some sort. 

The 41256 DRAM has an onboard re- 
fresh coitnter. so all that's necessary in 
the refresher is a timer flhe timing's 
tense) and a method of strobing */?^5 
while *CAS is held low. The power con- 
sutnption would be high, hut then we^ve 
an external power supply, so that's not a 
problem. 

Anyway, that's pretty much all I have to 
say on the topic right now. If I get any 
further with it. Vll let yott know. On the 
other hand, if you matiagc to come ttp 
with anything. I'd appreciate hearing 
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ahout it. M\ REU cauhi use the same 
irraimaif. Thank you for y<n4r rnteri'st, 
rm sorry I cotthhr'r he of more help. 

I just got Transactor 9:2 with your arti- 
cle in it. I am very interested in knowing 
how yuu managed to squeeze 1MB into 
a C64. Please send me any info you 
have on ihc procedure, is ihe 1MB also 
GEOS compatible? 

What other projects are in the works? 
How far could the 64 be expanded? 
Could another graphics chip be inter- 
faced to improve resolution? Could two 
64s be hnked to common memory to do 
multitasking or parallel processing? 

As you can see, I'm full of questions. 
Anything you could send to answer a few 
would be greally appreciated. Thank you. 

Dale Schoek. Hursi. TX 

/ stuffed a me^ into the 64 ushi^ tvi^o 
very tlijfereni techniques. The first, ami 
perhaps least ohvious - I expamh'd a 
I7f)4 REU to 5I2K. As you may know. 

m M 

this unit comes with 25(}K imtatted. Tak- 
hi^ it to 512K is as simple as opening 
the unit ami installing another hank of 
4l256's. The 150 nanosecond chips are 
the ones to use. They're designated vvilh 
a '15 at the end of the chip mimber. i.e. 
41256-15. 

fn order to install the extra RAM. von 
will have to clear the solder riiif^s, hut 
other than that, there's nothing else in- 
volved. Just a little proficienc\ with a 
soldering it^on. and the usual antistatic 
precautions. 

Now. concerning the 5I2K expansion 
hoard that I have installed in rn\ 64: it 
noM' looks as though Transactor will be 
puhhshinsi the 5I2K Vp^iradc arrulc in 
an upcoming issue. Because of this. I'm 
hack in development, trying to streanj- 
lir\e ihc hoard. So unid I test out the new- 
hoard. / really would feel uncomfortable 
re least Ui; that tnjonnation. Keep vow 
eyes open: it II he in a Transactor soon. 

As well, the anicle wilt present the 
driver that will conftgure the extra RAM 
as a 1571 RAM DISK, as well as allow 
the I7xx REU's and my RAM expansum 



to function losether. In the first article, it 

tvas one or the othet\ Not both. 

What other projects are in the w<n'ks'' 
Mostly, Tm working on software right 
now. and the upcoming Transactor arti- 
cle. Tve also been looking at domg an in- 
tertkd RAM expansion to one mes. ttsini; 
one mcfi chip.\^ It iiets a little ridiculous 
though. Through hanked RAM. there's no 
reason whv \'ou couldn't install 

+ 

megabytes of memory into a 64 (power 
.supply considered). But when you consid- 
er that a 64 costs less than $175 and a 
full megabyte of RAM $320... welt, you 
see what I mean. So. it .stops somewhere, 
probably where the cost of the memory 
exceeds the orginal purchase price of the 
computer 512K pushes it. 

Concerning some of your other ques- 
tions here. There's no sense in adding 
another VIC chip to a 64. No. it wouidnt 
increase resolution. In fact, it's probably 
impttssible due to the wav the VIC han- 
dles the address and data buses and re- 
fresh timing and bus timing, etc. What 
Tve always thought w<mld be a really 
neat option is a new chip that's compati- 
ble with the earlier VIC bur offers 
(through additional registers) higher 
resolutions, more ad ours. etc. That 
would be the way to go. But that's up to 
Commodore, so t doubt we'll see some- 
thing like that. Although. 1 have heard 
rumimrs that Commodore is considering 
a new S-bit computer that wfudd be 64- 
compatible. Maybe a 'turbo' 64 with en- 
hanced graphics and memory! 

And lastly, concerning multitasking. The 
5I2K board offers that option. The 256K 
mod. as you know, keeps a certain 
anioimt of memory common to each 
bank. The 5I2K mod allows vou. 
through software. t<f turn off that option. 
WhtO happens then is that, with a little 
bit of set-up, you have S absolutely sepa- 
rate 64K partitions. Each with its own 
stack, zpage. and Kernal vectors. The 
only thing that has to he handled is 
reloading the 110 chips <m hank switch. 
Ytm' 11 read all about ir .soon. 

Some aUeriiatives: I very much enjoyed 
reading your "C256" article in Transac- 
tor 9:2, To my knowledge you are the 
firsi to demonstrate a working conver- 



sion of this type for the C64. Now that 
you have done the hard pan, the rest of 
us can just sit back and wait for some 
cheap RAM lo come along. 

If convenient. I would appreciate your 
sending mc a list of any errors in the ar- 
ticle. I assume that on page 71 the AEC 
switch setting under B(ii) should read 
"enabled when closed"*, but I would like 
to know about any other typos you may 
have found. 

Congratulations on your successful pro- 
ject and fine articles. I look forward to 
future inMalmcnis. 

Concerning typos in the article. You've 
caught the glaring one. The rest are. Ui 
my knowledge, just misspellings, and 
those are mine, not T's. The onlv other 
thing is an omission in the code. In the 
header declaration, the icon is mi.ssing. 
Apparemty. the T is planning an errata. 
[The missing icon data is included as a 
"bloop" in this issue. - MO} □ 



NOW AVAILABLE FOR THE AMIGA 




The MicroFlyte JOYSTICK, the only rutly 

proportional conrmuousiy uanable joystick con- 
trol for Flight Simulaiof U 

It tfflnsforms an excellent program into a 

truly realistic flight simulation system B A C E 

M1CR0CUBE PRODUCTS 

Com rnod ore 64 / 1 2fi 

• MJCioFiyte ATC Joystick $59.95 

"TesVCaiiOration Disk^ A diagnostic tool tor youf 

jOysKik S4.95 

Amiga 

• MicroFlyte Joystick — Plugs into the mouse 
pon & works viTlh mosl software Sli9.95 

' Analog Joystick S74.9S 

Include S4 00 shipping of jOysTick orOers. FSll is 
a trademark ol subLQGlC Corp, 

Order Direct from; 



MICROCUBE 
CORPORATION 



-..«:-■■■■ 



P,0, Bot ABB 
leeshurg. VA 7207B 
(7031777 7157 
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Got art interesting pro}*rammius dp^ a short routine, or an unknown hit of 

Commodore trivia? Send it in - if we use f( in the hits coiurtm. we' li credit you in the 

column ami send vo/t a free one-year subscription to Transactor. 



Fas! CSraphics Primitives with SYMASS 
Henry CliU-. RoswelL New Mexico 

Robert Huehn's excellent Fa.sl GrapbiLS Primitives program In 
the December 1989 issue (Volume 9 Issue 1) of Transactor 
works well after being assembled using symass if the follow- 
ing minor changes are made lo the assembly code: { 1 ) Remove 
the comment after SYS 700 in line 100, (2) Enter 5700 .END 
as the last line of the listing. O) Change the code slaning ad- 
dress to 290 *:^$C0O0 or Mjme other safe location. At S9000 
the assembled code overwrites SYMASS's symtx>ls table which 
propagates downward from SYMASS causing SYMBOL NOT 
FOUND errors. 

Command Tails for the C64/C128 
Noel Nyman, Se^ittle. Washington 

At a recent user group meeting, a member asked me if it was 
possible lo pass data lo a program as part of the RUN slatc- 
mem. For example, CP/M allows you to type: 

"Read" is the name of a program to be executed; CP/M loads 
and runs this program. It also makes available the data "fde- 
name.exl'\ called the "command tail\ to the program READ. 
which can do what it likes with the information. AmigaDos, 
MS-tWS, and other operaiing systems also allow arguments lo 
be passed to programs in this way. 

At Hrsi, I said that you can^t do that in Commodore BASIC, 
then 1 thought about it a bit and realized that you can. and 
quite easily! 

When RETURN is pressed on a screen line, the entire line is 

transferred to an area of memory called the input buffer. "ITie 
line is tokcnized during the transfer: each BASIC keyword is re- 
placed with a single-byle token, 

RUN: "filenafflA 

On the C64. run can only be followed by a colon or a line 



number. The operaiing system ignores anything that follows 
the colon, but the bytes are still in tlie input buffer. All a pro- 
gram has to do is scan for the RUN token and the colon. 

A zero byte indicates the end of the line in the buffer. Any- 
thing between the colon and the zero byte is data we can ma- 
nipulate in any way we choose. 

Below is a simple sequential file reading program that uses the 
'command taiP to gel the name of the tile to read. 

Anything between a colon following RUN and ihe end of the 
line is placed in BF$. Leading spaces and quote marks are dis- 
carded. If BFS is null, there was no command tail and we ask 
the user for a file name. 

You could check for numbers, MS-DOS style switches (slash), 
Unix-style options (hyphen), or anything you want. You can 
do it in machine language, or keep it in BASIC, which is proba- 
bly fast enough. 

The C128 makes the command even more uj^eful. It allows 
RUN to also I-OAD the program. So, 

RUN "filfl reader": "filename 

...will LOAD the program called "fde reader" from drive of 
device 8 and run it. File Reader then parses past the colon and 
pulh "filename" in BFS. The main program then opens the re- 
quested file and displays its contents on the screen. 

It's best to use quotes ahead of the file name to avoid lokeniz- 
ing any basic commands thai may be pad of the name. 

AG 100 ren parse the input buffer fox a file 

KC 110 "cm vm folloHirtg rtu: 

10 120 xm by nul Dyivi 

SF 130 : 

PI HO f512 ; rem start of input hufftr 

Gfl 150 xx=592: cm change to ill for cl2B 

FB 160 ' if peelE[x)<13S m peeL(i}>0 tlm x=rfl: goto l&O; m ISfi^ian toku 

CJ 170 : if p«k()i)=D goto ISO: rea end of line in baffer 
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m m 

DD 20D 

KG 210 

PI 2M 

IL 250 

li 260 

m 270 

« 280 

FH 2»0 

PI 300 

n 310 

U 320 

n 330 

n 340 



, i£ pMk(xl=5B then r=itl; goto 210' rei found a colon 

, x^+1: if x>xx goto 250 r«fB n points to end of input buffer 

goto IflO 

if peBi:fji}=j2 and bfS="" then )p=xtl: goto 210; rem iUp leading spaces 
: it peek(xt=34 then x=x+l: goto 220: rea skip quotes 
: if p«elt(x)<>0 then bf£^f$fchrS{pfiAk[i)): x^4l: goto 22C 

4 

xf bf$="' tb«n u^ut entec file uoe. ",bf^: rea ao ugiauti 

4 
4 

<^ i5,e,i5 

op«i2J,2,"0:''tbfSv',s,i" 

uiputllS, X, x$ 

if Jt>l9 th»n print "file nine = "bfS. print "disk error-x.nS goto 39& 

gettJ.xS 

print xS; 



FP 350 wit 653.1,255: rra shift Itey pauses shift /lock holds 

W 3E0 ; 

W 370 

tf 3B0 

FO 390 

U 400 

KJ 410 



if 3t=C goto 32 D 

h 
h 

dose 2 close 15 



ind 



Quickie Flash Routine 

RJ. Poulin, Frederick, Maryland 

A short and sweet 'flash* routine for the C64 is always in de- 
mand. Here's one I use wiiii aiy notice to a forgeiful user to 
turn on bis printer: 

500 ren simple fluh subroutine 

510 Ml r.]. poulin, frederick, sd 

520 f=0: print "press <retum> »*hen ready": print 

530 print chrS(f)"tam on your printer' "chrS (145) 

540 get a5 f=18-f: for i=t to 250: next 

550 if *SOchrSH3) then 530 

5fi0 return 

C128 ML Muiiilor Tricks 
James Devlin, Decatur, (icorgia 

The following pokes will turn the RESTORE key into a monitor 

BRK key: 

poke dec("03ie"J -pee}c (dec ("0316") ) 
poXe dec ("0319" f , peek (dec ("0317" J ) 

Enter [he pokes and hit the restore key (you don't need the 
STOP key). Your computer will brk into the machine language 
monitor, just as if it had encountered a brk instruction. And 
the best thing aboui this trick is that the program counter and 
registers displayed will reflect exactly what the computer was 
doing when you hit RESTORE! 

This trick works by copying the monitor's BRK vector into the 
NMJ vector, so thai the non-maskahle interrupt generated by 
tapping the restore key forces a JMP to the monitor's brk 
routine rather than tlie normal NMI routine. 



Device Presence Checker 

Paul Sawyer, Oranges ille, Ontario 

Thi>; machine language program will report on the presoKe of 
a given device number. You can use it to check if the user has 

his disk drive or printer plugged in and turned on before pro- 
ceeding with an operation. 

The program ts relocatable: in this listing it resides at 49152. 
To use it, put the device number in location 252, then SYS 
49153. and PEEK location 251: if the result is j:ero. the device 
is off or not connected. 

If you check for a disk drive that is present, the drive error 
light will flash. Just initialize the drive and everything will be 
okay, 

BASIC Loader 



HG lOO 

HJ 110 

Ji 120 

JD 130 

EK 140 

KJ 150 

LP 160 

Dt 170 

HP 130 

DK 190 

JM 200 

KF 220 

BH 230 

HK 240 

BC 250 

OF 260 

BG 270 



device presence checker 
by paul q 5awy«r 
itore devici \ in 252, 
syi to roirtir* 149152), 
then peeM^H]. if vahe 
Q then device is off, 
1 then device is on. 



ren 
ren 
r» 
ren ^ 

m then peeM^^l)- if vahe is 
ren 

reo 

rem if device checked is a disk 

ren drive, initialize after calling 

ren routine , 

for i=49152 to 491&l:re4d x:poke i.x.next 

data 169, 0, 133, 251, ie5. 252, 170, UO 

data 0. 12. 186, 255, 1E9, I H6, 251 

data 160, 0, 32, 1S9, 255. 32, 192, 255 
data 165, 144, 72, 165, 252, 32, 195, 255 
data 104, 49. 4, 169, 1, 133, 251, 96 



Source code 



300 

OJ 310 

OH 320 

HK 330 

Ns m 

DH 350 

FJ 360 

CC 370 

Jl 380 

KG 390 

JK 400 

FJL 410 

CK 420 

FI 430 

DD 440 



««Sc0D0 

.opt 00 

device = $fc 

onflag = $fb 

Ida 10: ata onflag 

Ida device: tax; Idy tO 

jsr $ffba raitlfa 

Ida II: Idjt onflag: Idy tO 

jfir Sffbd setnan 

jar SffcO :open 

Ida S90: pha 

Ida device; jsr Sffc3 :cloae 

pla; boi off 

on Ida tl sta oitflag 

off rti 



□ 




hp-!flch InternatlDnaMnc. 



JITLT 



AdrtOLwl Lo^CXJlPf bvAff'^Tl 




INDUSTRY FIRST - LIFETIME COMPUTER 



SERVICE PFRff.CTtO\ ~ hfefime y^'arrann- for C-64/ US Campuiers!.'.' 

E.Xilii.sneU_/m», TOP TECH IVORI.D. ISC. 

l-lal Smkr Rair« — hAS'F. fmfriMimjil SrrtKc 

Full line nfCRM <-i^inpiEicr\ & prriphcmK. TikiLrp Supiilir* Uir C-f>i H-yi wimnlf}: 

Safiwair Hard-li>-r}itd ;k^ns,Sfr^Kf Munu^K. Pmccchvc Device* 

VISA, MASUH CARD DISCOVFR, \Mf\ 

(SOeiAi.V^MOl ■ III2S DcliiwiK A^f . PhilBdclphiA. F*A I»I47 • ai5)3*9-W0I 
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The ML Column 



Crunching: from order to chaos 



bv Tiidd Heiiiijrck 



II doesn't seem lu make sense. Crunching reduces the size of a 
file without reducing the amount of information there. How is 
that possible? 

If you've used programs like ARC. you know ihat. however it 
works, it works. In this article, we'll look at the classic crunch- 
ing algorithm called Huffman envuding. 

Huffman encoding and other compression techniques usual- 
ly reduce the size of a file. However, you can find mathe- 
maticians, computer scientists, and other theoreticians who 
can prove that compression algorithms can fail. Once in a 
while, you crunch a file and (surprise!) you get back some- 
thing that^ bigger than the original. That*s the chance you 
lake. 

But that's a reasonable rule. If you owned a crunching algo- 
rithm that guaranteed a 20% reduction in size, you could run 
the program over and over again to compress a whole encyclo- 
pedia into one byte. You'd just run the output into the input 
until it shrank down to whatever size you wanted. 

The theory: making chaos 

The basic theory of crunching is that you look for patterns of 
order in the input Hie, You then replace the patterns with 
smaller codes that will later expand during the uncrunching 
pmcess. The crunched file is more chaotic and more random 
lin an orderly way) than the source file. 

As a very simple example, imagine thai a text file contains 431 
instances uf the word ""ihe". The word "qz" appears nowhere 
in the file, mainly because it's not an English word. If you 
seaa^i and replace "Uie" with "qz", you save 431 bytes. Two 
letters have replaced three letters. But youVe made the file 
more random. At some point you run out of orderly patterns 
and you can'i compress any more. 

A benefit of crunching is that you save space, wheflier it's disk 
space or memory. A drawback is that it lakes time to crunch 
and uncrunch. 



Huffman cnaxlin^, which is capitalized because it's named after 
its inventor typically reduces a file by 20 to 40 percent, some- 
times more. It works best on text files, which alx>und with space 
characters between words. Text tiles also have a lot of charac- 
ters in the a-z and A-Z range. They're predictable and orderly. 

Enough theory. Let's cninch something. 

How it works 

The writer A.A. MUne, autlior of "Winnie the Pooh", wrote a 
poem that starts with these lines: 

Of all the Knights in Appledore 
The wisest was Sir Thomas Tom- 
He multiplied as far as foun 
And knew what nine was taken from 
To make eleven. 

To introduce the ccHicepG of Huffman cotling, we wiil crunch 
those five lines. Including letters, punctuation, spaces, and ^\\t 
carriage returns, there are 143 bytes to crunch. 

On the first pass of the Huffman program, we count each char- 
acter's frequency- Next, we son the letters from most common 
to least common- That list is used to create the Huffman codes, 
which are labeled HCODES in Table 1 . 

Columns 1-3 list the character, the PETASCII code, and the fre- 
quency. Columns 4 and 5 give the Huffman code and its length 
(note that the length varies in this example from 3 bits to 8 bits 
and that the most frequent characters have the shortest length). 
Columns 6 and 7 list the number of bits for the Huffman code 
and the number of bits for the eight-bits-in-a-byte Ascn code. 

Take the entry for the letter 'A", for example. It looks like this: 



193 



IIIOOI 



12 



16 



The PETASCn code is 193 and it ap[>ears two times in the sam- 
ple text. The Huffman code for this particular example is 
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Iubjf I: Charackn Sorted by f 


"requeocy 




1 




CHB 


ASC 


FREQ 


HCODE 


HLEN 


HBITS 


8BITS 




ape 


* 32 


23 


000 


3 


€9 


184 




e 


fi9 


14 


110 


3 


42 


112 




a 


65 


10 


0100 




40 


80 




n 


76 


S 


1000 




32 


64 




s 


83 


8 


1001 




32 


64 




2. 


73 


7 


1011 




2B 


56 




1 


76 


6 


1111 




24 


4B 




t 


64 


6 


00100 


5 


30 


48 




O 


79 


6 


00101 


5 


30 


48 




r 


82 


5 


00111 


5 


25 


40 




h 


72 


5 


01100 


5 


25 


40 




w 


87 


5 


01101 


5 


25 


40 




m 


77 


5 


01010 


5 


25 


40 




<• 


13 


5 


01011 


5 


25 


40 




f 


70 


4 


01111 


5 


20 


32 




T 


212 


4 


10111 


5 


20 


32 




k 


75 


3 


11101 


5 


15 


24 




d 


68 


3 


001100 


6 


10 


24 




P 


SO 


3 


001101 


6 


18 


24 




. 


46 


2 


011101 


6 


12 


16 




u 


85 


2 


111000 


6 


12 


16 




A 


193 


2 


111001 


6 


12 


16 




f 


44 




0111001 


7 


7 


a 




S 


211 




01110000 


a 


6 


a 




O 


207 




01110001 


e 


8 


a 




K 


203 




1010110 


7 


7 


8 




B 


20D 




XOlOlll 


7 


7 


8 




V 


86 




1010100 


7 


7 


8 




9 


71 




lOlOlOl 


7 


7 


8 




•The 


»pace 


character 


and the carriage return are listed 




asspcand 


<- 













11 1001. which is 6 bits long (in anoiher exmnplc. the code 
might be something complelely different). In the crunched file, 
2 limes 6 is 12 (frequency limes length). In a normal ASCII file, 
two 8'bil bytes wou!d need 16 bits. For this chumeter. we 
crunch Ifihirs down to 12, a savings of 25%. 

Comparing the HBITS column (630 bits) against the 8BITS col- 
umn ( 1 144 bits) shows that using Huffman codes should save 
45%. Actually, as we'll see in a minute, the overhead needed 
for the code table wipes out the savings. 

It*s not at all obvious where the Huffman code 1 1 1001 for 
"A" came from. We'll ^el to that soon. But firsts let's examine 
a coded line. Figure I shows the characters of the first line of 
the poem. The Huftman code from the table above is under 
each character. The bits are repackaged as S-bil bytes, which 
would be written to the crunched file. The commas would not 

appear in memory or in the file; they're included to visually 
separate the bits. 



Figure 1; Crunching "Of all the Knights of Appledore<** 



spc a 1 1 ape t 



e spc 



01110001. ouu m, 0100 iin, ini m 0,0100 0110,0 110 000 

m S7S «4F SfO S« $S1 



1 g 



spc 



1,010110 10,00 mi 10,10101 011,00 ooioo 1,001 ooo oojoi 01111, 

5SA m SAB $09 $20 $ir 



spc A 



1 



e d 



r I < 



000 11100,1 001101 0,0:101 111,1 110 0011,00 00101 0,0111 no 0,1011 
$1C $9A IGT na $0A $7C SB? 



Uncrunching 

Now it's time to uncrunch the file, which you may notice is a 
lot more chaotic than it was before. The letter "i" repeats three 
times, for example, in the original hne. Not one byte repeats in 
the crunched line- 
Before wc start to uncrunch, we should briefiy review binary 
trees, A 'tree* is a data structure made up of nodes. There's 
always one node at the top, A node can do one of two things: it 
can terminate or it can branch- If ii branches, it^s called dpar- 
eti! node and the nodes below are called chUdren. 

In a binary tree, the parent nodes can have only two children - 
not three and not one. If you branch to the left, you find child 
0. On the right is child I . (Other kinds of trees can have more 
than two children, hut we're using a strictly binary tree for 
Huffman codes.) 

The Huffman codes listed above happen to fit into a binary 

tree lhat\ illustrated in Figure 2. 

To uncrunch the Huffman codes, we need to do scnnediing 
called "traversing the tree". The bit pancms of the first two 
bytes look like this; 

OIIIOOOIh OlllIOOO 

Start at the top of the tree and read the bits from left to right- 
First there's a 0. which means you move down to the left to 
child 0, which happens to be a parent node- Next a I, so move 
down and right to child I, Then right, right, left. left, left, and 
right. The eight node terminates in the letter "O^'. Print that 
letter (or send it to an output file) and go back to the top of the 
tree. One left and four rights takes us to the terminating node 
'*f". Prim it and go back to the top. The next traversal does 
three quick lefts and hits the space character. 

You might ask the question "What if one code is 01 and 
another is OlUl?" How do you know when 10 stop and when 
to continue? If you look at the tree, you'll see that a node 
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n 



f 




S 



V g K H 



Figure 2: The binary tree 



cither terminates or hu children. h\ imfH>ssiWe lo have bodi 
01 and 0101. Since the spm:c tlMnictcr !aans with 1X)0, no oth- 
er characners siad with OOOs (vshere x UaOor l>. 

How lo ^niw a tree 

Of course, ihc next question is how do you create a binary 
tree? WclK we want it lo be 'welglikd", which means we want 
the popular characters near the lop (a shon path) and the 
unpt>pular ones near ihc Knuim (ii longer path). 

Let's start with i small example, Suppo*ie you have a file with 
six characters distributed like this ithc "t" means "icmiinaiing 
node"); 



pOl 


16 (chlldTM tH «nd tQ> 


tA 


IS 


to 


12 



Combine the two bottom nodes lA and lO into p02. with a fre- 
quency of 27 and surt again: 



tT 

p02 
pOl 



» 

91 

21 (children tA mtid tO> 
16 (Ghlldr«n tK «nd tQ) 






ts 

tT 
tA 

to 

tM 

to 



50 
31 
15 
12 

• 



The priKess continues until only two mxlcs remain, which are 
then hooked into the node at the very top. 

Hum lo u&e the pn^ram 

Say you want to crunch a scijucniial Hie called zebra into a 
sequcnlial file called 7 IRIFF. Load the Huffman program into 
memory and run this program: 



After sorting the frequencies, you sian building nodes from 
the houom. Combine iN and iQ into a new node called pOI 
(the "p" means 'parent node"), which has a frequency of 8+8 
or 16. It replaces the second to the last node and we delete the 
last node: 



ID oral 3,0,2,-IDM.a.a": SYS 49152: AIM nUT PA5S 

20 C»1H 3,»,3, rttHA,I,m*: Orai 4,i,4.''t mJIT.S,lf": SYS 4915S 



The file ZLHUFF is created- In addition, the original file size and 
the crunched size are printed on the screen. 

To uncrunch. run this program: 



ts 


SO 


tT 


31 


tA 


15 


to 


12 


pOl 


It 



10 



5.>,5."l,Ban'>S,a-': OPW 6.>,S,"CK7mLX,S,*f: SYS 49158 



It's imptirtanl thai the flies be opened as nuniliers 2. 3. and 4 
when you crunch and 5 and 6 when you uncninch. 



The tree Is still sorted, except for the final node. Next we per- 
form an insertion sort, to put that node in its right place: 



tK 

tx 



50 
31 



Pr'jj^ram Votes 

The program has three pans: epassi (49152). epass2 (49155). 
andDBCCM)E(49l58)> 
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TV EFASS1 n>iitifw cmmt^ the byie** in on XTT\f. which 
Ibc frcquciKic* m (he lal^lc^ i iKigu) and 4.lKLgHE ([he C 
mean* "chaj,Kicr">. Then if soils the liM in SOUTKM, »1»ich in 
lum calls isoKl, ihc iiliCRion mwi muiinc. Ilicn MAKFTKFil 
hinItU 4 ircc. I'hc node fra|u^^^.^v^ iire stored in SFREjqlo and 
M KFOHr The codes arr in sawf The parent ntxlc^ for char* 
aciers «e in CTMjDii. fur iiudc^ they're in npnod£. 

Dhs^: won't wofl unless j-i'ASs hj\ been culk^J first. It 
>end» oui a set of b\les that describe the tree. FirM, the lolj^ 
number of hvfcs is sent ii^o b\lesL then the number of chif- 
ictcrs Lh^ii branch left (the zcru&> and each unc'^ parent and 
name. Next, the children who branch right (ones), the ninles 
thai are Oob. and the ntxlcs thai art 1^. 

The overhead ncottcd lo descrihc \\>c tree incnascs the sire of 
the fiJc. E or examine, the poem above ha» 143 chanciers. bvi 
onty 29 arv uniquiv The header needs 29 \in\c\ 4 plu*- Z bvien: 
IIH b>ics in all. Jhc 143 characters crunch tkt^n into 79 
bytei, but when you add Hie overhead, the crunched file con- 
tains 197 h>ics (compared to 143 in thcorijinal). 

The llufTman codei» follow the header In ihc example jN>\e, 
Ihe Icilcr "0" luu Uic code lUUU. Ilic tables are arranged b) 
parent nodev so to fifiure out the code, the program works 
backwards: 0, i\ 0. I. ^^hcn it ^cts to the lop, a revene^ the 
{reversed) bits to get 1000. The variaMe-lcngth codes mt 
packed inio bjlest of eight hits each and sent out to the 
crurwhed file. 
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LO M 



a 2»cciii 
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Ui 
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II 

Jl 
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II 

a 
jr 

o 

JD 



fr 

m 
u 
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ttiu > tir-UM 
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r fM) 



ftH 



cftild D 



put 



or 
a 






MttlteliM 
talUtki tnt 

tte tif «r til mt 



Hie DtcoDL roulmc uncrunches Holhnfln codea. Il ^U up a 
table (rHONAME, CHfmTE. on\ wfr. and onrvreK Note thai 
this is a table of children, whereas the cnccxlin^ rouitiK used a 
IbUc or parents. In the decoding procevs. the program gets bits 
or>e ;ii a time until it gets a child ihafs ^ Ji.u.Kler, Then il 
|oe& batk lo the lop ol tlic tnre. 

How uiil dovs il wurk? 

In some tests 1 ran. \cx\ files cniiKhcJ best. A I54()0'h>tc file 

crunched down lo 9118 byie» ifrxMn 61 disk blocks lo %). 

Tlut'sa4l%savinf!fc.l1ie?'U.HWCecode fn>m this program, 

uhich IS ntusU) ic.\U reduced from 10126 b>te& tu 8218. a 

194 savings. The Spr^dSrript pfofiim (all machine lanfuage) 

didn't cnjiKh ver^ well at alt. probabl) hc\.ij^' of the 

overhead. It shrank slightly, from 6I5J bytes to 6042. a 2^ 
savings. 
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32. 20r 

197, I, 

32, 307, 

32, 301. 

0. 2H. 

IH, IH, 

23, 141, 

12, 207, 

151, D, 

11 »7, 

12, 307. 

0. 3H. 

IH, IH, 

IH tl2, 

255 141, 

IH, 172, 

U, 105. 

0, ir 

312, 244. 

IH, IH, 

la. f, 

31. 310, 

m. 159, 

173. IH. 

1« 5. 

m. 355. 



141, IK 

3H. 3 
33, IH 

0, m 

in, I 

203, L53 

3H, 343 

41, 141 

134, 113 

IH, 113 

IH, 33 

in. iH 

1, m 

31. IH 

IH, 12 

155, IH 

IH IH 

255 157 

117, 3H 

355 340 

3SS, HD 

111, 

m, m 

IH. IH 
359, 197 
ir, 3H 
259 340 
355, 171 
IH, W 
IH, 2H 

9, 13 
1C2. IH 
10, IH 

I, IH 
2H, 10 
214. 119 

t, IN 

12, III 
359, 2H 
IH. HI 
tH. 13 

s, m 



New! Improved! 

TRANSBASIC 2! 



with SYMASS™ 
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"I used 10 be SO ashamed ol my dull, messy code, but 
no matler what 1 iried I just couldn'l get rid of those 
stubborn spaghetti stainsf" writes Mrs, Jenny R of 
Richmond Hill, Oniafio. 'Then the Transactor people 
asked me to try rww TransBASIC 2, wtth Symass". 
They explained how TransBASIC 2. w^th its scores of 
tiny tokens*, would gel my code iooking clean, fasti 

"I was sceptical, but t figured there was no harm in 
giving rt a try. Well, all it took was one load and I was 
convinced! TransBASIC 2 went to work and got my 
code looking clean as new in seconds! Now I'm telling 
aH my friends to try TransBASIC 2 in their machines)" 



Tran»BASC 2. with Symats. the symbolic anambler. 
Package contains ai 12 sets of TransBASIC modules 
from ihe magazine, pkit ful documentation Make your 
BA5C programs run faster and better wtth over 140 
added statemem and function keywords 

Disk and Manual $17.95 US, $19.95 Cdn. 

(tee order card a1 center and Newt BPK for more mfo) 

TransBASIC 2 

"Cleaner code, load after load!" 
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TtAPI 



DOS 



AND FOR CP/M COMPUTERS 



So all your friends have 
IBM's and Macs? 

Now you can feel 
sorry for them. 



S-- 



.■■■.•\-> 



^ ' 



. yA'X 
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L^V^O 



THE SUPERFAST PARALLEL DOS FOR THE COMMODORE $4/128 AND 1541 




You^ « Commodor* ountr. YoUVt qoI gratf 

colora and fantastic sound, dynamic f#a]uras 
VM IBM and Mac owners can or^ draa/n of. 
YouVa got K all - axcApt spMd. 

WM, you doni hava to ba laft in Iha dust 
anymoral Lawranc« Hilar, ona of tha oriQinal 
''Basamani Boya*. bringt yo<j tha most axcitinQ 
davatopmam in tha hWory of Commodora 
compuiart ' RaplDosT Packad with faaturaa, 
RaptOos will transform your skig into a buUal • 
|Mt Ilka a look at tha chan batowl 

Gal your RapiOoa, thM invito your IBM and 
Mm triands ovar to saa your 'naw* supar 
computar. But ba nioa - maka aura thay'ra slQing 



down bafora you bk)w iham awayi 



Sampts RaplOoa Faaturat: 

• ALL dttit accasi commands axacuta at sup«rfast spa«dsl 

• DasiQnad to support multpla drtvasi 

• On boaid DOS Wadga / Scrsan Duo^ / U-L Monrtorl 

■ Cantronics parmHal prirrtar support ava9k>laf 

■ FuUy Commodora compaibla A your canndga port is iaft fraal 

fUplDos Profaaalonal Faaturaa; 

• Olv«a avan fastar disk accass than RapJDosI 

• 8K RAM tradi buflanng and Kardwara OCR oonvarstonl 
« Providas 40 track vxlanson [749 blocks FREE)I 

• AMa 20 NEW disk commands (bdt ViWs. ransma disk, alc)l 
SPECIAL: RAMBOard^ capabiHtias a/a buHt in! R^>iOoa Pro 
can usa MavancA^ paramaiara to backup son>a of tha 
nawMt, hottest titlas on tha market lodayl 



ParsfW Wmmm OM AvmtUhim For Votft Vmvhnm - Onty i1§.M 



Function 



Normal DOS 



RaplDoi 



HapiPoaPro 



Your Svatam 



Sjr. 



1?fl«^.fr>nrf» 




Jl 



.*•!»*' 



M 



iA 



RapiDos - Only $49.95 / RapiDos Professional - Only $119.95 

Mmttmh/KitMi Rap-Dot mtuirm m aodmma kwrntt ROM LM tn your C-64 fUfiiOoi m tmiy t^^tm^^ 10 9m Pnhitbn 
mtioa. TtmfUfnOot Pnl**tnfml dm* coi^vtm » CiM? mu Oam GbR. »m cn^kn ol fm t»tt p^aM tyMtnt in Eun(,»i 
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THE MSD MASS DUPLICATOR 



'■41 



tfww«*>W«iiMf» 



• nmmu 
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7^ THE MSD MASS DUPUCATOR ONLY $39.95 

■J <fc^^ j^^ *^,*- Q^tvw w A^tPCcpr ROm Cfon f»tt 
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TURBO 64 






»ii 



Turbo 64 11 MOO 



C-64 Burst ROM C*126 Burst ROM 

Exceed ThB Speed Ltmt 

flQOt^^V***" . 

1»fi^«tVWiiea»VrfV«t«Bii S«iB WtoM 



e«4 Bunt ROM Only $3995 (M28 Bunt ROM Only SI9.9'' 
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\>^^V;-^^^X 



WV^W :' X ^ v.--^- V w»M«««rti»<wt»Av.: vv 



somuRRi 







^i^H I^^^^K H ^^M ^^M ^^K ^^^ ^^^ VBA 
^P^^ l^V^^^^ ^* ^^V ^^^ ^^^ ^^^H ^^^K V^K 
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WtaCMOl 
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Mi««i«^^PSv^tol«"COS 
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m%k^ 






GaiCMMbw«a«i«ii 



rrf^^Tr^^Wll-rMll^iinMmgrMan^li^lT a^i 



IWTERNATIONAL 
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M«n04t rFt4«f 

A^*H ^^v fr 4>' Ji -|Hv# #^ 




DCAIERS - WE HAVE THE SUPPORT YOU'RE LOOKING FORI 
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The Edge Connection 



Experiences with a RAM expansion unit 



h\ JiK-1 M. Ruhlii 



On Bu\in^ Day (nol a holiiluy ticirl, having looked fir and 
\(id(r Tor the m}lliKMl 1750 512K kam Exp;in^ion Unit for 
ihe Cofnmodorc 128 (which appean lo be on eternal back- 
ordcn. I :jr.ihhcj a 1700 for $90 (lis). Con(rar> lo ihc 
promises on the box. I received neither a "new" CT/M dii^k 
nor the RA\frM>s u>fiwart; bui, mocc ihc price ^^\ rijzhl and 
I ttlrcud) had bulh pieces of sofivtore. 1 did nut ^i^icuiii too 
loudly. 

The newcM version of the L).S. CI2K Kemal (&FFKO contain* 
the tdcmifytng value SOI and the C>M\ Ktmal jump at SFF50 
jumps to Ihc patch area at SOW) fixe^ three bugs with uma 
acceftft. First of all. as previously noted in Lhis ma^a/inc. it 
tcmp^>ranl) ^tiul^ oM ituvkaNc lOlcmjpts (SLLj v^hivh could 
fonre the C 1 28 into BANK 1 5 before the deferred mi\ acxeu Is 
con^UfnlTlala^ (If bit 4 nt ^DMM l\ m>[ m-i - uhtch is il>c way 
BASIC does it - a DMA pfi>LCN^ i\ not carried oui uniil the ncU 
write toSFPOO. Bu(. iho \mi and [By routines write lo SI 1(10. 

kcuing BANK 15 M>, if thc> liappcn ai the wrofij^ Lmke, ihc DMA 
inDKfer wilt take place ftam eakk 15, even if yoii Ufimed 

BANK 0.) 



j] Of course. or>e cannot \hul oil iH>n-niaskiiHe inicfiupK. so be 

carclul with the KKMuKh kc> aiid pseudo-KS-:33 activitiet. 

Secondly, if you request a uma acuvit> u^mg bank I kam, the 
new Kemal nniline temporarily switches the vic/wiA RAM 
BANK rci"isier<bii6of SD506)io BANK LThen:ti>a\ with new 
Kemal 128s. ccmtiary to the kEl manual, vou do not have to 
do this voun^elf wlien \ou tk* a B\si(" n.rcH. stash or swap 
involving BANK 1 RAM - juM mc the BASK: *BANk T' JOalC- 

mem. 

However. Ihc new Kemal call doe^ nrt lemporarily switch to 
SLOW inode> so you will still have to swikh lo I Mil/ your- 
self. (Actually, DMA operatKMi» Kem to work cooectly in 
FAST mode, but Ihc 8502 geu confused at the end of the pro- 
cess and tends to drop mio the monitor.) 

H Final]), under the old rnunne. there waN some tn^uhlc wiih 
the I/O chips (SIXtUO-SDi'FF) always being in context during 
a Kemal DMA operation, causing emtrs fand likely, crashes) 
when you tried lu um uma (^fatioii> chi ham under the vo 
page. The new Kemal routine fixes that. 
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Word processors which allow you to load the whole dictio- 
nary into the REi' and then automatically check your 
s|vllin^ a« you type, soch as Fapenlip III)I2H, and ihc 
newest version of UiW/'rii t2H. won't do this auiochecking 
if you only have I28K of rfi". but Papenhp can load all 
the overlays you want mto ihe R£L\ GEO& 2,0 and geos J28 
won't allow vou to use a I2HK RFU at a RAMdisk. but vou 
iUH configure a 128K KLL for fast rebooting alter cxiung tu 
BASIC, and/or lo tpeed up GCos appMcationn by allowing 
Ihc VLIR o\crl;iys lo be stored in ihc rill. Fast rcKHiiinp 
dties not rc<|Uirc the cop> -protected GEOs key disk - only a 
disk with Ihe lUskTop. (ifiipn»urammer\ su(>cTdcbuggcr, 
a?i sophisticated a debugger as iji found on man) mam- 
frames, works fine on a 128K reu. 

Of cour^, all but the earliest versions of CF/M allow the tue 
of a I2KK REt! as a Rwuiisk. device M:, Not all cp/m soft* 
ware supports device M:, iniwcvcr, you lan gel around this. 
First (due lo Ken Ftippo writing in November Wkk 
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fOGMOtts. POG. RO. Box 3474, Daly City, California «0I5 
U.S.A.. Tck-pbono Ul.^i 7?*5 20(10) yew can piAc ihc address 
of ibc RAM iliNk UaiKlkr inio ihc UPH pixnitr mMh-n^ ol' the 
logical di*\ drive you \^ant the k \\T di\k to he. Fin i-\;miple. 
in Ihc K December 1985 BIOS, di&k drive C: has \i\ Lablc enlr> 
It 0l-HD5h nnd the RAM &x%k handler is ai OFB%h. tike the 
hM>2, the ZXO |jke\ av VMiuK lowbjlc fifM. Ergo, 

conf pok# fbd5«9<fb 

would set/change device C: from device 10, drive 0. lo ihe 
RAM Oi>k, OFBDIh i> device A:. 0JBD3h in device H;. aud so 
on. If you want, you can pul Ihi* line in a pmfHe.mh file, *o it 

,iuiiMiiLiiK;illy huppcn% on txxx. Or, if you arc j t;in;iiic. vou 
cun cilJier hnd ihc piUch addrcw in your vctmoo ol ci'M*MS 
jnd moilifv it or. if vou Uasc the source code for vour Htc>s, 

WW w 

^Uk MHuve code for one of the December 1985 mussi U 
included in the CP/M development p:ick.ice) you can change it 
,UTd rciiKsemble il. When I exutnined ('/'W*.sy.s with xid ,ind the 
CI38 naiivemodc monitor (which, unlike M. has a hum 
function L I did not find an immcdi-ncK nhvious paich sp^it. so 

this chore IS ictt as on c&cnise to the re^ider 

AccORling to Miklos Gjrajnvc^h) ^ (.»',M+ nicinory map 
{TransarUtr 9:2 or Twin Citifs t2S Usue ?!> Ihe entry for 
dc\ice A. IV .ir iif HHIh in ,il1 \er\ions o( tP/\1+ vihich suppon 
the RAM c.\)>.uider - all Deccmbcf and Ma> versions, (August 
veriions use a diflcrcnt a^ldrr^s hut di>n'i suppi>rt the RH t 
Hovbcvcr. d you have a version odKr than 8 December, you 
may wish to check the value of the nwu handler. Use: 

ooof tfuaip fb«9 
and suhMitutc the fifiirtWD values for 9(ii-B above. 

One CI28 CTAI user. J. Ualtnp. made several nKxlilicauaotlo 
his BIOS. Tile source Md objecl codes are available, among 
other places, on hk* disk IKfv Mr Wuhrtp has the KWtdisk ,is 
device D:, and he also eliminated vinual drive E: aikl 40- 
L'^lumn suppi>rt. 

An RH" al^o pn^vidca n way of trvi^feninp files between Com- 
TtuKkHv LUIS and CP/M, To copv a file frotn <tai to Comm»>Jtia" 
i>os. pipit totheREi andirboottoConim<x1ofeix».Ona 1700. 
Ihc file hegiiw ai Kmk 0, Siisrir* Tl*c directory entry, near the 
bceinnin^ of the KJUj. >how> how lon^ the file is, in the standard 
I I'M dircclory enliy mcth<xi. Wth the 17(1). each alUvalion umt 
i» IK. and llic sann: stKHiUJ be Wlm: willi itic 17M. However, smcc 
each allocation unit has a onc*byic entry in CP/M. if you have ft 
1750, each alliKjjtiofi unit muM he 2K i5IJ!Ky236cmrics), 



than one file, you can ptp them together - making ^mr, if they 
art not tc\l files, that pip is in bman mode. 

(For ffgMvly ^hon Hies, thece to an efti^icr methiHl not involv* 

ing the KLL - from Commodore LXJS to CP/M. load the file in 
BANK L beginning at SICOO. and then boot CP/M+ and use the 
CP/M+ program wise Iwkc, To gel a file intoComnuxinre [x>s, 
inc lid or ddl on it. Move the area from S0100 to S03FF lo a 
bi^jlicr area in memory (since SOKMl-yi.lFI ii hwk I arc 
ordinanly invisible in 128 mode). Now, hit su^r^v^^i ojid end 
up in Ihe monitor. Your file iv in DANK K> 

I can't gd my 1700 to wori with my old Cardcu mulli- 
cannd^e hvird. I don't know if this is Jusi a lack of pti\ ^^ical 
contact or thai the lA) expansion lines aa' butlcred in wmc 
inappropriate way. 1 have trouble ustn^ the Crardco board with 
•omc (but not all) bank-iwitched cartridges which use the 
SDEOO or SDPOO vo e^panston spaces. SiBion*i basic 

work^il !mu' ^Hlh Elk' 4 ardci» l^iard -iiui .i M. but ikU with ihe 
Cftrdcn bo,irtl and a 128. lit works fine on ihe 128 without the 
Cardco Ixurd ><>n the other haikl. both the 128 and M mukIcn 

iA Cincmii ware's )^tsrpipeetl (my I'avountc conndgc. nght 
mvw) work with the Cafden Ki;irtl. ami (he M mode uses the 
SDI:1KI i/i> \pacc for bank swuchm^, I ntonunaicl). Wurp- 

speed alw uses the ^UIHX) i^ ^pace. which is the satne 
addreaa as the ram expansion conin«ller chip, mi there is mi 
hope of using both \\arp%peed and a Vlxx ai the same limc - 
even with a different muUi -cartridge board. 

ISlop the prviafi.' Thh Juu In from Joel:f The problem with 
m> I7(XI Rtt and Cardco cartridge lumcd out to be entirely 
physical - the I700work« fine with it r/you remove the plastic 
outer shell of the 1700. Hlls^L■ver. because of the SDPOO cixi- 
fljct \ou \iill can 'I use the I7(X> with Warpspeed. 

Interrupts and Ibc CI2S HU-culumn chip 

Hwe lias been vrnx.- queaiion a» to just when you can u^c an 
interrupt nxitine which writes to the C128 VDC chip. Tvc been 
pUivin^ wiifi thl^ .1 bit. ,ind m> Lonclusion seems lo be th.ir .l^ 
long a> the main program i^ not ui an actual routine which rc4id» 
or w rites to the MX" chip, you aie aafc - pnnided ihur you utxr 
aruiu -li'it M;(;/i/cTi $/2 cj/tJ j/.^, the RAM addrcvs rcgiMcrs. 

For wclflvhaved pn>j:niiti^ i|>n>gnim^ which \ta> with tlx' nor- 
mal tcM scrreru and onl> usic (he iviven editor Rt>M routlne^ lo 
read or write to ihc VDC) you vh**uld be safe as lonj: a.s the hiph 
b) tc ol the pa>gram C4xinter is nut SCD. If you are using a ^nu- 
gram which do» weird fhin^ to the VDT chip uting its own 
RAM-tu-^d nuitnicv suth a> tift>\ /2*V or HWii .S, all bets air off. 



I 



I 



Going the mher way, first K><>r ( wm. To cfcate a directory 
entry up ui &4K. UkC sft%c to ^ve a Tile to itk: kll. If you liavc 
a bigger file, ymi can cieiH moir than one file, each in multi- 
ples of the Ki.i jlUxjtion umt (IK or 2K|. Now. rebtnu to 
Commodtire DOS. put your file in llxx memory, beginning at 
^ISIMI, \\i\\l n, and rebiHPt ( I'M. Sincvihe RAMdi\k survives a 
reboot, )our file will now be in device M:. If you have more 
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ll }ou Mam u> be ii bii ^cr, you can make sure that Lhc high 
byte of Ihc vc U no! between SC4lir> ^md 5CFFF (The lasi pj^o 
and a haJI o( KXHX) i\ j pauh oa-ii \o (here mi^hi be mjak* 
ihinj! having lo iki wiih rbc VDC in the fiituir). Since tfw com- 
puk-r spends much o1 jIn lifiw in a wailing Kxifi anHifki SC2(M». 
Ou^ i& much bcucr ihan ^'4J(KK$CIW=. I have included an 
imemipi '*Jri vcn clock routine which v^ill nin in either l(>fi> or 
cj^l) colunui ic\i okhIc. 

Ht}. wanna l>u\ a cheap or j>h^n? 

I KHicc thtf m least *ine mail 4)n*cr httuie (AnKTican IVsign 
CoiiipLMKnis, lux Ik^v 22ft Faii\ic*. NJ U7022, telephone (201) 
941-5000 or \m.h 524-0809» is prtim^ rid of PTuV4s for S49.95. 
These are nnunxxl maLh^n^:^. kji [hey ha^c been tested. ^ lut con 
you do with a P\\ss/4 f no aanlomical ^uggcstioas, please)? 

Hme ift. or wat, a PluV4 uM:ri* group at P.O. Box lOOL Mon^ 
lervy. Califomii. M> kval Toys-R-Us. just d<«wn the nwl 
Intm \\}dn Ejq^'s lonibsiunc, camcs a word prucc^MV and mn 
Kcounttng package for the Plus/4, Thcrr are «d» for various 
projrrams, including an assembler, in Ihe pit^ies oi Comnh'cli'rr 
CtmipuiittK lntcrnaito9iaL The assembler \s sold b> a Bniivh 
software house, SuperMifl, whii\e pmducts air sold in the 
U.S. by Skjlc* Uvctrk \\urk&. mi one might check wiih 
them. The Ptu^4 can mn many basic 7,0 graphics proL'rann 
written for the 128. 

While Ihe PltHM only haa 40 colmRs. it does have a 6591 

LARI. M> It miglit be umhI for tnuisferhng files ttviuHn Com- 
modore DOS lo cMher machines ai a high baud vaw. iPupt-ntip 
Ill'l2f<\ leleconiiiiujiicaUufi*^ module aikJ GrtdMui boih have 
9ft0() baud wtting*. So, if you do some aA bii twiddling, 
ralhcr than usnig ihc Kerrul roulines. it should be posvible to 
u>e Ihc CI 28. and maybe even the CM, at 96UU baud. I sua< 
peel Ihal even with ihe faiKu'^i hit twiddling, you'd still have 
to shut oil the C12^b4 40-culutnn wiren to achieve such 
speeds, and you might need ;i gtxxlh number of nulls if \ou 
want to scroll \\w t I2H Kt)-colunui sca'ciK) 

\lo\inj; forMiird with iht- Kbit line 

Finallj^ftllip^tllA^BapBMie^ mmnur column. A^^ordini: to 
the JanuaiyVMnLiT} issue. CunuihAkjcc wa-s thuikiii^ ol puuin^ 
i>ui a supcr-M or super- 1 2«, and one of the quesitof^s they were 
aNking was. "How ctimpaublc nmsi ^ucb .i nuKluiv he' " h\ffi 
Mid, "100%". But ihis wwld preclude such goodies jr a 65816, 
a built-in i \h\ at SOEOO. a budi in 1750. a b^jih-m 3.5" diOt 
drive, ct alia. I thmk that il Cmiunudoa-'s H-bti line i» to Mirvivc. 
it muit like the Apple ixis. move forwiird with the limes. If ii 
does, il will cxMitinue to get ihml pari) ^u|)(X.iil. U' it doesn't, il 
will, like the Aian X-bit line, become just a cartridge game 
mac bine. *- 

By the way. if C<imm(xicire J* interesled in com|vtin^ with 
cannd^c ^ame machines, suwh as Ux- Niiitciidu, il could bnng 
out U)e MaJ( Machine. (Thi« wa« a game machine with which 
the C64 i* upward toiupatible. It was never bruu^hi out in 



North America.) Thi» could eaMty he sold for S5U u s) \\s\ and 
would have all the simnd and graphics facilities m iIil- CM, 
Aiul, It woukl give us Comnrndure H-bit hackers a new almost 
pirale-pft^>f iriMalled base for which to program gjincv. 

Clock3re: CI2H imrnuphdrhrn clock rout'me for 40 or S() 
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The C64 Power C Shell 



With notes on tnodifyin}^ the shell for REU users 
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by Adriiin Prpprr 

In a pfcviiMjh ailKic ("On The C Side", Tranuutor, VoJumc 9, 
Isvuc 1 K I hinted ut theabilily to um: P^twcrCwith j r\m disk 
in u 17M KtL. bul gave no dcuih. Usm^^ tlic K\M Jivk ^^>lt 
ware provided with ihc 1 764 rrqiiirc^ a 2^ h>lc papc of regu- 
lar C7>4 H VM U> he %el a\nlc tor ihc inEcrljcc to iJk- r \m di\k 
feortware. In ihc Mandard Power C cnviionnK-nL it is no* poxM- 
ble todoihi%. 

Whai Tollows will ■' ~- vonie KnVcround lo The explanation of 
making the KAM divk soliuaix' work with PdwctC. ll digr^'w- 

ts a bil. but ihis \houki help lead lo heiier underuandin^ ol ihe 
Power r cnvtronnicTii in );cncraL bvcn rejdcrs \^ho di»ni use 
Power C may Jind thi^ iDteicMing and helplui. especially if 
they are con\iilering puaha%ing it- 
Oven lew 

The CommodtHT 64 ftiwcr C Khcll i\ a machine language pru- 
grwn that toads ai ^SOL and cvcupiex the mcnxiry iilmovt to 
SIMIU. U 15 dcai^ieil io wuik easily wiLiiuneur iwodrue^aia 
lime. If recofnixet a work drive, whetv user files fsourcc, ob- 
ject and cxccuUHei should be. Jiid j sysUm drive, where tile* 
such » fhc different p;is^e% of the compiler, and ohjeci li- 
braries aa* expected to be. These mii> be iwo drives m the 
Mmc (dual drive) device, or drive<b in separate devices. The 
default conftizuraliim when the shell is run is suitable for ;i sin- 
gle drive ftyslcnu itthl has lx»Ui assigned lo iIk same drive (dc* 
vice H, drive 0). This confi^umtion is iisnhle. hut nece^sitatei a 
lot of disk s\^appmg whcnconipilm^ di'^A liakin^ po^^raim. 

Once ruvrinf. the sbi.-f1 nMtK lines of user input from ihc 
screen- It parses ttic hncs mtu word^ (!<cric^ of nonblank char- 
acters), gathcrinp them as the 'afpumcnt*.' to the command to 
be cveeulcd. Gentrr.ill). cath word bcLomes a separalo argu- 
ment; the following ehamcto^ cau^ certain exceptions: 

" will turn a series of ctwrac l e n fc, including blanks, into a sin- 
gle argivnenl. untifa closing double-qiutle is found. 

< will use the word following it as the name of a sequential 
tile, ll will look lor ihe lile on ihe work disk, and <*pen it «& 
sttindtinl input for iIk' command executed in response to the 
ctmim^ind line. Neither the '<' nor the file name are actually 
parsed as arguiikcnts to ttu: cunuiianJ. 



> will use the word lotlowing it as the name uf a scqucndil 
file, II will attempt to create the file oft Ihe wort disk, lo re* 
ceive yUwJmJ otit/ntt for the command executed, A special 
case is '»\ which w ill cause standard output to be directed to 
Ihc printer. 

The firvi affumeni foimi! is lakcn as the name of a command. 
FirsU the shell chcck> lo see il this i> one of its own tMuUin 
commandsr 



b>c: cuit to BASIC, 

1: list directory of work disk. 

h: list dirccU^ of s)siem disk. 



rm: remove (scratchl a file. 



iBv: nio\c (rename Ki file. 



pr copy a file on the work disk to sfxindard ourptit. 



: send arbitrary i\^ c o m ma nd to work device. 



load: load, txjt don't nin. m appHcaiion pntgmm. 



:aei or display the work dcvkeand disk numbers. 



$jf%: *iet ordispla} the system device and disk numbers. 

Most of these commands will use oihcr arguments thai may he 

present on \hc coiiimand line. For imtaiKC. the 1 ^iMi b coin- 
mands will use an optional filename pattern. t>elails are given 
in Ihe Power C manual. The ouipul redircLiiiMi \^ ill work when 
appropriate, lo send ouithii 1e,g. a dtiwtorv listing) to disk iff 
printer. 

If Ihe firM arvumcnl is ntvt one of these buill-ins, il is assumed 
to be Ihe name of a user pr\>gram. First ihe work djsk is 
searched for a program file named as the first argument suf- 
hxed with ".sh". H it is not lound nn ihe wi>rk disk, the s>S' 
tern disk is seaa^hed. If found ihi one of the two disks, the pro- 
gram is loaded ai address $1800, and c;illed bv the shelt ^^ a 
subroutine. 
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Thi?k in^es Povtcr C a very taikimbic environment. If you 
can cxprr%s j certain command as a C program, you can ea^ 
il> aiid II lo your d>uiUblc 'MKabulai>'. The number of ar- 
gumcm^ found on the command line is passed to the mainO 
rouiinc of (he C pm^iram d\ H% first argument, with a pi>mlcr 
to an array of character poinler?> to each of the commanU line 
arguriK-Mis boin^ p;i\sed as the second <lhe iractirioiul itf^i 
and argit, AU progrunu rcuJ Iruni ^ujuianl input anJ ^nte 
10 tUndard ouipui h\ default, ^incc these can he 'redirected* 
on the command line, numpulalLn^ Iilcs is espccialK Cit\\\ 
Several noi-no nmple C applicaiions are supplied In %ouae 
fomi on the Power C disk, includm): a tesi fomuEicr. an ob- 
ject fdc library editor, a 'filter' lor bidding page headmgs to 
s<iua~c nics in preparati^m for printing, and a program to 
Kcaai) ii Ilk tor a tcivt pattern. 

Power V tus aiioihcr fcatun: to speed ihin(Siip. Since Ihc shell 
built-in ccmimands do not u?>e the RAM (rxNn SI 800 on, a user 
prognm that has been lo;ided there remaiwk uninuLhod b> 
iheoL ThePcfofC a comaund program wiJl not even be reload- 
ed from disk if its name is tfic tame as the last uvr applicitioni 
run (or UmJcJ usmg the load ^oinniaiKJi lliis s|X\'ds up ihc 
rerunning of a pmgnrni, and using the load Lonkiiiuiid allows 
MarKlard inpui data to be on a different disl Irom ihe prt>grain 
even on a onc-dhve setup. 

But ihis ^an <au^ tonu: peculiar hchavioar. If a prot-ram b 
run ?t trcond time without reloading, if/^ha/and xtatit data arc 
"a'nieniheied" Irom the pa"^ious run. Thus. C progfium origi* 

aalint; on other unpleiTK^nuttiwis ihat are ported' 10 Power C 
often must he nHxIified to expliciiK iniii.kli/e large portions of 
ihcir global dau at ruii-Uiikc Static tUu \hai b local lo a func- 
lion must often he moved outside the function so it can be ini- 
tialized. 



As an aside, noic thai the WlieM way to gel around ihi-i 
problem (until the offending program is modified for the 
Power C en^imnmcnu is probabh h> writing' ilie shortest C 
program: 



t) 



I 



I 



or, if you prefer, ihc s|K>nesi nuKtune language proLr-im. usinj; 
irrv assembler f>ackage yoit like. a< Umg as the load addre^^ 

emh NP..>S1«00: 



tfta 



\nmc the re^tiani pr^ram "unkwd". or wmething similar, and 
execulcU when UHi \saiil to torvearcloadot anutlKjr pntgrain. 



$ 1 7f a: number of dcv ice containing s) stem disk. 

SI7fb: number of dnve eontaininc s\ siem dislt. 

$17(c: number of dc% kc coaianiing work dtsk. 

$17fd: number of drive containing work disk. 

$l7fe: Hag: n [tk^hs st:iTh];ird input is using the default 

Kemal litrin device: I means siaadanl infuii is 
Kcmal logical file #1. 
$l7ffi flag: mcaii> *tlajkiard output ls umii^ the dclault 
Kemal chnna dt%ice: 1 means standard <iutpul is 
Kcmalktgicalllkffl 

It can Useful to inspect these ItKaiions from C programs. For 
in^laiKC, >ou may wont lo suppa's^ prompts if ^aaiularU input 
has been redirected. Of courNC. this will have the disadsama^e 
of nuking the C source ConinuHk^e 64 dependent. 

In addition, a few run-time nnitines frequenti) used b\ C pn>- 
gianis .uiually reside in ihc sliell. There is a jump table to 
ibese near ihe hcpinning of the shell, each entry consisting of a 
jitip instrucUon to <hm: oI the loUowing routiiK-^: 

SaOe: initiali/L- shell 
»11: cSnOlcodc 
S8I4: cyunctjmi code 

S8I7: priiitfw^ 

$Rla: f print fcoAc 

$8 Id: jpTf/if/code 

S820: vSgetv code \ pan of Kcuhari 

$823: eX:/^*2code 

The cSfunctJ'^if muline diws quick setup for a C-callable ma- 
chine-language routine. It is used b) Ihc pnntj coik. actually. 
The iSH02 rnutTtio simpis pishes the accumulator onto the C 
run-linK Mack illic |x>iiuer to which is ItKated in Sla^lh of 
jero page). The cS2W2 routine ju&l calk cSii02 to push the 
value zero onto the C runtime stack. 

finding a free page for the Jt \M dfsk Enterraee 

The Power C shell occupies or use^ nearly all the memory be- 
tween SM)I arkl SIKJNl. C application programs aft loaded ai 
$1800. They set up their run-tiinc Mack to grow upwards from 
Ihe end of the Uxulcd a>ile This slack iv used for automatic 
variaUes and some parameter passing, and is pointed to by 
($ta,$1h) in the reio-fiafe. Memorv' dynamically allocated by 
ilw C library routuK-s tmiUtK. mitin urul iriitliH is taken fn*n» 
the lop-of^memory down. Applications running under the Power 
C shell potcn[iall> use all n>ernon. \^hile the top-ot-ntcmory 
can be mu wubui a ungle C prugram by tlic Power C ruutmc 
hif^cm, it eannot be set iot the eniiie envtnmmeni- ST:tndard 
programs such as i\U the excellent Power C text (stnircc tile) 
edili>r. and vc. the compiler command, w hile they air fxn C pnv 
grams. \MlUenainJ\ U} ii> use all Ihc asailahle wmnff* 



M4'inor> uMipe by rpmi^riims and the shell However, by rrwrilinp the shell, it has proven possible to 

squeeze a free page in there. By corefull} coiiipaviing the code 
When ninnin|!, a C program relic** on some locations in the a little, and re-«ranpnp the u^ of memcwy within the shell- 
shell s memory aa-a, among diem: the page from S 1 600 to S 1 6ff i page 22) can be freed. 
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By luuiUjni^ ihc ram Jidt wflwire and specifying page 22 js 
the tnierfKC ptgc. prior lo Itiottin^ ihc \pck.i;ill> rcshrittcfi nH^II 
and runnmg iu dJ C prograim will \«i>rk, aiiJ Llic kAM disk. i% 
made accessible as a di^k drive. 

Other pn»bkms land Hxet) 

The onl> hitches occur when itic kam Ui^ dijc:^ noi bclui^v 
quite like other Comnnxlore disk drives. For iaalancc, j m;»jnr 
problem IS (hji ihk.- ^ I projzram, whjch loads aiuJ funs ihc i^o 
ptiacs of die C compiler j[k-iii|iL\ to concntrnnte two fife^ hy 
%eni]in^ ihc worV disk dri^c the <,nnini,ind: 



oO:fil« o^ 



Wei), the RAM dhk dne^ noi *iuppon concaicMfion in this fn^h- 
ion, S*> e%en Ihou^h ihc two passes of the C coini^ilcr would 
Itxid and run properly from the KAM disk and produce correci 
luiiput on a regular disk drive, the fiiul iihicvi lilc would run 
be produced coitcllI) if \hc RAM duL ibcli 'Aj^ bcinjt u&cd as 
the Power C wori disk. Bui jl \\ aKo p<w\ih1e to rewrite the n 
command to [VtIooti the concaicnaiion hv reading and wriling 
ihe files, it wa* while Aiing this rewrite that 1 discovered the 
bu|E in R\\U>'>s V.^ referred to in 'On The C Side'\ H,»ppil> 
ihal bu^ lua been iiAcd in the mure recent RaMIxjs 4.2. R ^vf 
DOS releases can be found ihi van<ius BBSs, and it iv good to 
If) and ^ct a.s rccciu j ^ crMon as >ou can. 

In jrcncral. lliou^tu most programs reading t>r writing multiple 
tiles on the RAM disk are surprisingly slow, I think the process 
of «wiiching from working with one file lo another in ihc HSM 
disk suliwarc is quite »luw. Perlunnancc seems lo improve lui- 
tkcably if rhe input ,ind output is heavtf\ huftcred, 

A plenum worklni! enrfmnmrnt 

Alter writing ihc nHxlificd shell, and the n* command. I com> 
bined them w ith a couple of other sup[>in utilities inh« a com 
pa'^scd archive file. s/uMium-un. I ha\e uploaded this tu U^ 
Pro-line PowerC Bbs<4I6-276-68IIK and I think it may by 
mm be availid>le from other plates as well (including the 
TrunMti to* disk for this issue I. 



So with the modified shell, and ilie k r command, I have a 
Power C envirDamem in which the c*liii^r !o,nK insiiinih. and 
lakes only a couple oJ sccondi to Kuil oi save lafgc source 
files on the ram disk. Although ihe actual compulation -bound 
oimpilatjon p^^n.esse^ arc n*n mueh taster, e^cn when ihc 
source ill on the ram disk, there are no amH>vmg delays while 
each pass of the (.xwnpiler is loaded. In addition, the amcalena- 
tion of ihc iwo icmporaiy files to produce the final object file 
is a lot faster, and anrt easier on the hardware, both disks and 
drives, Oikc compiled, even large programs l^ud ui the luiic it 
Ukc^ to lype ilk-ir name. 

In facu when using Power C with the RAM disk, I often think it 
is a great tribute to Power C that I was able to lolenite usin^ It 
with regular disk drives ai all. Q 



Bits & Pieces I: 






From the famous book of the same name. Transactor 
Producttons now brings you Bits & faeces I: The Dtskf 
You'll thrill to the special effects of the screen 
dazzlersl You'll laugh at the hours of typing time 
you'll savel You'lf be Inspired as you boldly go 
where no bits have gone tjeforef 

"Absolutely 
mmgnetMl" 

Gene Syscall 



"Extrsofdtn^niy faithful to the pkx 
ot the book. . . The BAM atone is 
worth the phce of JKim*ssk}nr 

Vincent Canbyie 



If you mount only one btts <Ask in 1 967, make n tha 
onef The fully cross-referenced index is unforgetiabtel 

RecsRead, New York TIS 



AAHNING So"^ 



Mu'lDvrei HM^Q<^H 



arn a nCCB 1 T>€ DfilC A Mylar Fikn. in «uoci«rton wth Tf vKjoor ProduO^ 

It^lV^ « « drfvr nrv yoirf 

Disk S8 95 US. S9 95 Cdn. Book S J4.95 US, S 1 7,95 Cdn. 
Book « ask Combo Just S 1 9.9S US. S24 9S Cdnf 
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Inside Geos 128 



The info you needed and couldn't find. 



h\ UilliamCtilcman 
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Geos for the Commodore I2H has been available for quite a 
while ™>w. A ncvw ami improved vcrvion (V2.0» ha^ juM been 
i deaa cd> Unfonunately there Mill are very feu oppLicauuiu 
written specifically for it. Most ;ir' vimply CM n^ns prupmnf 
that wiU nui m 40-<olumti mode. Oik: o\ ihc bi^cM nhMJClet 
has been a lack of information. Thi« aniclc wilf attempt to 

mncUv this \iiuaiion b> pRWidiiii; jII of ihe inlitrmjium 
required to pntgnim in 80-coliimn m^nk'. There iMi't emiu^h 
rvKHn to te;k:h o^ivs prognmmini* from scrauh: therefore, the 
ujdcr i% aMumed to already be fdrndiar with glus prugrdJti- 
mtn^ on the CM. 

Which is which? 

Beture >uuf application can do iU job. it iKcd.\ to know what 
cmnj^iiicr and what Tnode it i* ninnrniz umlcr Gl-OS fthmugh- 
oui this arULle die tcnn (iEUS ih um^I to signit) Gtjos I^H, 
unless st:iTed oiherwisel provide^ two variables for the purpose 
ol dincferUiaiKfn, 

The first. avaiLible to all \ersions (VI.3 and tdMwe). K 
cIZKI-Ijib (SC0I3). If bit 7 \s mti ilien the ap|>lKation j*^ run* 
ninj: umler fiFOS !28, Note that the 128 DeskTop wt!l parse 
oui programs Ihji ^jji'I be run under llie comrnt mode i>r com- 
puter (we'll discuss just hou- a bit later) but ihe M IXsklop 
can I, If you art* wntiniz a l2K-onK applk.ituHK it will need to 
chesk thi\ flag to make sure that it isnH being run under litas 
M. I \c ihis muiinc to check: 

Cb#clcFut«« : 

1<U 1112 



fitaphie diwhlin^ 



bpl 

IdA 

101: 



101 

ci2ariB9 



The SO-volumn icfcai is, of counc, twice as wide aj* die 40- 

colunn iCRCn. Orm pn>vide« a means to automatically dou- 
ble the Width and/or \ position ol jH ^T;iphK\ drawn on ihe 

screen> The highest three bits of the width/X pmiiton byte (or 

bMcsJ an? ii^L J for lliis ;is fiilKms, 



1» 



1 
1 




Sit 
14 

Q 

1 

1 








X 



I vaIu* 

% • t - n 



&■ is t positive 
aa i« (n*^ativ« 

OWifclMd positi 
Dooblsd nsgati 



lu«> 



Nonnally you won'r acoeiilhe^e bttv (tirectly htit \vil1 instead 
use i\w mrwGBOScoiuunis AI>Dl_\*. \uin_H. ikh hi r_w,and 
fMM |I1.E_B, Simply OK the appropriate constant or constants 
iriio the width or \ |TOMlK»n v;tUi^ ! se the byte (B) coosianis 
in thofte areas where a byte (canJj value i% required. i.e. icon 
i;iMe>. Here's an example: 

■ylconTsb: 

,byt« thlcMny 

.MC4 M«I^CtJDOaBLK_lt 

.byt* B*#Top 

flratlGon: 

■ord ayloon 
,byt« ImttMOgmi 
ij%m yfoa 

byt« vidtb k DOCBLKJi 
hyf hsl^ht 
byts Sarvic* 

> • • #te ' 



After calling llii^ rouiine. Bin will branch if niitnin^ under .i 

The second sariablc. called Kraph\h>de, it av;ijbhlc lo cfos 
1 2K only, all versions. If bit 7 is set then you are in 80-column 
mtHlc. Virtually all GHts graphic and icxi muliiKs check ihi^ 
vanaMe to find out what mode is jlIivc, 



The newer versions of PutChnf allow sou to pass iMfaiivt X 
pu&itioii valuer In lltcsc caM!*h >uu should ujk \\\c coasunt^ 
radwr then oRlnp them. This will maintain the bit pattern 

required (or negative valuer. 

An astuie reaik't will pfoKiblv remark that aii> number when 
multiplied by two will be even. Therefore, you would imm be 
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able io aoccisodd pr>s1li^n^ ffor clearing rtie loeeii. cu:.). To 

ge( an^uiiJ ihis pn»b)cni Minj^h uk -^mU \i>ni_H "t vdih w u^ 
appmprialc- ThU will add one in the rinil result The v^\y time 
ycHj Mill nomullv nceJ ihi^ in \*hcn clc^nn^ (Ik v^Tcen (i-e, 
31911M>I Ki |,\^UD01_W), 

The rouiinc u%cd to perform all of this miraculous doubling 
j« caUed SormafiZfX^ It will he called auiofnatically by all 
of the GliOS ^luphic and text rouiinc^. In 4()'CoJumn niiHlc 
ihi^ routine will rts without doing anything. You can, if 
you wii^h, cull it fnim uithin your application hul under 

nonnal circum^ianco (i\ there really ^uch a thing?) you 
shouldn't have to. See Table I for a more complete de^^ciip- 

lion. 



Graphic ■■dllK-M 



WTiilc OBOS l> will correctly handle dniihTinc bit\ nr^Mrdlcss 
of the sidco mode, GEOS 04 doesn't knu^ duublmg bits tiuiii 
Adam. If \ou try to use ihem the graphic rouiinei will try lo 
print way off the screen \*iih ob\Kmsl\ lou^> rrNuh%- Thi* 
makes crratmg a program that will run in HU-column 128 and 
GBOS M rather difTit. uft. 

PpoMMy the easiest way to write a totally compatible prrvpram 
i% to keep track i>t .ill the placcx in x\k p^'^Mfn where di»u- 
bltng biv^ are required, and poke the appnvpnate valuer in dur- 
ing initialisation. 

In Ih4>^<" places where the value is loaded into a register, try the 
fallu\hing: 



MyHorvLS 


litsX: 


3»e 


Chmck^vtmr 


tal 


10$ 1 if C12a 


1(U 


$01. X ; it's a 64 


aftd 


f«00011111 ; so olMT th* 


fltft 


aoi.a f doubling bits 


10$: 




rts 




Convert 




: pass: 


r2L-[4 just liks in ftsct.sngl« 


piM 




tMm 




phm 




IdM 


tr3 


Jar 


Mf/l^tmMliMmX 


1« 


ffr4 


lar 


l%«offawli>«x 


pis 





pis 



Now dmply use the doubled forms of alt X positions and call 
Convert before all calls to Utt um^U. l-rameHeiiati^U\ etc. 
Adminedly. thi«i is a bit ut a kludge but it worts. 



While all of thb U a pain for smaller applicatliMis. it gels dam 

near imposxiblc to majiitain \\\\\\ larger ones. I1iis is v^h) nunt 
large applications have two ver^ioitt - oiw forui-X)^ 64 ainl tme 
rorihel28. 



The 128 memory 



The main geos I2X bank \s bank I. It i!^ vinually idemical to 
theGEOSM memory map \sith ihc lolluwing exceptions: 

l> The in.ktc.i i^ always baiAed In. 

2) Tlic MML can be *ecn at SITOO- 

3) Because of #2 the input driver has been moved. The input 
driver (able is Mill in iIk' vinie place un this case, at the rnd 
of the driver instead of at the betiinning). 

Under nomui circum^uuKCS (i-c, when ai^hcatiuti code >:> 
eaecuiingi. there U no common ram denned. There \\ a sec- 
tion of the utOS Kental in high memory oi hank n. When 
GGOS needs to acee^^ thi^. tt ^* common RAM high and this 
ji Mill Hip in. 



The Ttofispritc variables nrsidc in bank between SOIOO and 
SilM'. VVIkcn tliese variables iKcd to be accc^^cd the Kcnial 
will set common R^M low, 

GBOS I2K does not swap memory lodisk the way the GEOS M 
docs. 1n^lcad it uscv S2UM> to S^FFT of bank 0, Y^hj can uae 
ihu area as a butler but it >oui a^^ltLation load.s Dckk Acoc»* 
■ories thi^ area w ill be trashed. There is. imforlunately. ik> way 
to pre V cm this. 

WMIc at first glance >ou \^ou1d think [he 128 haa much m<»re 
room this is not really the case with iMJ^ 128. The active font 
must be in t'nMil RXM iKink IK as mu^t the sprite pidurrs and 
all tables pa^M^d to ubub iouimc». \^'hlic Uicn: i^ a large area 
in Kick RAM (bank 0), it is hard to use and will he trashed by 

UVs- 



on'Raj^ 



Evciy CSOS file has a flag in the he^uler bkx.k at position 
OlFIStfLAOa. Thi> rlag telh the OGOS 128 Kcnial v^hat com- 
puter and/nr mode the program can run under. Only the high* 
est two hits mailer: the rest should be zero. 



bit 7 


1 


1 



bit « 





I 
I 



40-colwHi nods only 
40- sad 00-colupn aodss 
Doss not run undsr GCOS 12a 
aO-coluBD Bods only 



Note ihat this Hag is not PDCogni/cd by any cjfco^ 64 vcruun 
(which is why /en* nwans 40 ci>hjmn only), Yoo can some- 
times change this flag with interesting rc^lti^. Botii 
gtmAt^tmMrr and geoiJnker arc set *o that the>' will not nm 
on the I2S. Ho^^c^c^. vou can clian^c this flag and thc> uill 
nin just fine! In fact. ir)x>u don't mind a weird looking screen. 
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>(>u can run ihcm in m-column mode ai iwicc the fMwmaJ ehc <kMinaii*>n. When swapping mcmoo in Ok ^lanie bank the 



S4>iiic n;i^i> t>ii9 

Thav «e a couplo of serious Nigii that >ou should be aware 
of. If S130U i> iion-/cn». ihc xtiKsprik- will n*H functK*(i pri*]-*- 
cf\\. ThU one i^ a real pain to work around. If po\siWe. Mjn 

yout pn»gT:tinv a! %\M1i^ ami iniiLc ihc llr^i invlRKium .block 
1. You can then u^ S0400 lo S 1 211 lot buUcn.. 

Since ihc firM \crs%M of Utus iherc has been a bu^E in the 
menu h.MuWcr that prevent* menu^ fmm gwng p*W position 
;??. I nli>nu[iJkl> ihisalsi^apphoiorhc 1> \cr.ion\4^\rn in 
go-column mfHirf This one can be ^uitc ditticull to work 
ari>und il >\Hi use targe nierni^ 

I ran up ajiainsi ihis proWem when I wa^ writing my 128 
inminal. In -Ri-tolumn nuHlc. ihe nuim nicnu cxicnded lo 25,V 
In WVccMuinn mode thi^ iransbied to about 330 (the BSWHO 
font IS a^>ul L3 times as wide as BSW-iol. Of course, il 
wouldn't work. What I finally did waa fool VieSysWrnfoni 
into thinking it was always in 40<olumn mode so thai il 
would always rcmm bswi*:*> It works firw like this but the RO- 
colunm menu i* awfully riny. Hopefully, v:.0 has fixed these 
priiblcais. but I'm not holding m> breath. 

The following ijblcs provide all of the new routine*, variables, 
etc. I would suggest making up a [kw ukIuOc hk^ ^.ilkd 
Kfo^tlHSym. You can then include it in all of your 12K pro- 
grams. If you jkld cverylhmg to gtotSym you will waste 
a-ssemUy time reading variable^ that arcn i used. 

TaWe I - OEOS 12H RotUmf Dtsiripiitms 
Di.Bt^p-iCZtC 



Ptos: i« 
rl 
rl 
rJL 
r3H 
Y 



- BI.KI. Pointer to the sun ()f a btiKk iif nurinoiy. 

- BiXZ. Poimer to the start of a block of memory. 

- Number of h> tcv lo move. 

- Bank of BLKi (U = bank 0. 1 = bonk I } 
-Bank of HI KMO^ bank 0. 1 =hank 1> 

- Mudcol^i^ .,ijonas follows: 



hill Mt2 

U 

1 

1 

I 1 



Move from mjci to BUC2 
Move from BLk: to liLKl 
SwopBt-kl withBLU 
Verify t>nly 



Return: r*-r,l unchanged 

X o = nijich.JFF= mismatch (verify only) 

Destroy: a. x. y 



Hidi'OnhMifUsc • 



Pass: nothing 

Destroy:!. It. y.rl-rt 



Return: nothing 



This riHitine is used lo enac the mouse Mjlt&pnlc from the 
screen when in WKolumn mixle- Il will be redrawn during the 
next pass ttuuuitti Mam Loop. Ihis rviutinc will have mi etlo-i if 
called when in 4(Vco1umn nKxte Usually it is best lo call Trmp- 
HiJ^.Uoi4H'. Since the graphics n>ulirn:N use It-mpHtdi'MHtse 
this miitine is w^wthless if you also call a graphics rouunc. 



Mo%ennaf;» ■ S(-2E3 



P»a:rt 
rl 

rl 

r3L 

r3H 



• Mnter to start of the sot HCE block of memory. 

• ftniuer u> -^t.irt of ins r i\ \Tlo\ bkvk of memory. 

• Number ol t)>u^ to move. 

■ scHRn Bank (0 = bank 0. 1 =bank I) 

- UtsUNAIios Bank 0-' - t^jnk 0. I = bank 1 ) 



kcIUMi; rOrJ unchanged 
Destroy: a. ».y 

Thii foutinc simply loadi V wiih /em and calls DoHOp. If 
both arcu* ate in the same bonk then or-STiNArio\ umsi be less 
than -iot RCE. 



Niirniali/eX-SC2E0 



% -Poimer 10 the zero page word lo normalize- rg. 
U>x #r3. 



Return: x -unchanged 



Dc-^iroy: 



This riHitlnc is used to conven dnuMtng bits to an absolute 
value. ^mpliMiHic is checked and, il Ljlkd when m M\ 
coTumn mode, will simply strip the doubling biu. All tiLus 
graphics umiuies call this routine- so nomialK an jppliciiion 
will not need to call iL 



SetMousc <FFR9 



Pus: nothing 

Destroy: assimw m. i. y- r#Tl5 



Rffum: rH>lhing 



This routine is a tow level, general purpose, bank lo bonk I his rouunc i« called b> the interrupt rouhne just after the 

memory move rouMne, If K«h uniao ,uul dcMination addu ^s keyboard is scanned. Il's job is lo reset Uic TOT lines. This 

es are in dw same bank then die wurvc must be greater then i s only necessary for a mouse: all mhcr Jr^vers will simply 

TfQMOCtOf 
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JtTS. An af^icaikm 
directly. 



Mver need lo calJ ihi» routine SMNimM^mIc - M 2U0 



SciMwPlc.SClDA 

Pa^^: rt poinlcr lo ,12 bylc* of dala Hwo 16 hylc inugcs) 

Of AKKdu to %\Mkh loilieckfaalL 



Roium: ntxhiog 



IX*Mruj: II. \,y, rO rl5 



This rrMitme \\ u\cd ro change the shape of ihc mou\c M>ft- 
ipnic <#(l> jn MK^'iumn nii.\W\ Unlil^c the other -icven *ofl- 
*l>rites. ihe mow Wtspritc h highly ofximi/ed \o thaf ii win 
ninLlJon MTloothI) a\ ;l mouse. It i\ onl) IhxH pucK in w/c. 
The fina J6 bytes of the tiible are a mask image. The Um 16 
bytes are Ihc pi^iarc iisejf, Tlw mouse hamllcr will firsi \sd 
the area with ibc ma&k image. Any U'> in the m;isk will clear 
thai piiel on the ^c^een- Then the imiijre it\elf is oR'cJ in. 
HcR:\anc\uinplc: 



ic 



LcwatrO 

sta 



D«faultt4ou««: 



; aaeeo tc stor* word in Kl/Lo ord«r 
,B«cro mtord «ord 



MSntC 



rword 



>rd 
zword 



rvword 



tOOOOOOOOOOOOOOOl 
tOllllllllllllOll 
«Clllltllllt0111t 

«oiiiiiiiiaiiiiii 
toiiiiiioiiiuiii 

«011tl01111111111 
^OtlOllllllllLlll 
lOOOltllltUlllll 



rword 
rword 



rword 



rword 
cwcud 
rvi#6rd 



tOllllllllllllOOO 
%0110000011 100000 

*011000111000000D 

toiioiuooooooooo 

lOllllDOOOOOOOOOO 

toiiooooooooooooo 

10000000000000000 



Vijiss. firaph.\h>dL- - mti to the NEW moda 

Return: nothing 

Alien: riiihiUar^itK clkrcg, uitU / H'SysianFoni 

Dcs!rf>y: a. i. y. H)-rI5 

IWi routine is used to switch graphics mode. The applicatfoft 
must redraw the new stnrcn iiscll. Note tJut / wSwu-mf^tt/K b 

^.Uicd; sa if you arc u^ing a custom set, you wdl have to re* 
enable iL Here\ an c sample : 



; ficst •r»»* old acr^^n 
)ax i^jlftctAn^ic 
.bfta 0,l»ft 

.word 0,319|OOaaL^1f|ADDlJI 
; ncNi airiceh modmn 
IdA graphMDd* 

atiooooooo 

grii^iHoda 
^ar S«tN«irtC^<la 
; fbow laitlallia thm naw lewB 

jar DraH5cr««n 






Sw^BDtta - $r2F6 

Pa^i-i : rfl • BLK I . P<nnier lo start of a hlock of memory. 
rl - BUU- Pointer io start ul a block, of mcniury. 
r2 - Number of hyic^ to mo\'e, 

r3L ■ li.ink oi BIM (0 = hank O. I = Kjiik 1> 
r3H - Bank of blk: (0 ^ bank 0, I = bank I) 

Kciutn, ii>-r3 unchanged 

IX-strov: a, it,y 

ThiamiJlinc sinipf> loads Y with iwoand ulK /^>flO/>, If hi«h 
are in the itajikc bonk then blk: must be kss then BLKi. 



Tf mpHidrVlouw - $C2D7 
Pau.: nothti^ 
l>:vtroy:a, s 



ReUim: nothing 



TUa Touiinc is u&ed to craae all of the ?^lispricea from the 
screen when in 80-column mode. They will be redrawn 
durinp the nc^t pass ihroujzh Mam Loop, This routine \mII 
have no effect if tailed when m 40-column mode. All the 
Ot:os graphics routines call TvmpHideMouxe before tlr;m- 
ing to the screen. The onl> time an applicaiiou will uccJ 



J 
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10 call il in when manipuliiling %cf«cn (ytx*) memory 
dircclly. 



CXOIM 



\trif>lll)»la.W:il7 



PMt:f« 
rl 
r2 
r3L 



- BtKi. Pointer to the stan of a block of nieniorv. 

- BLKJ. Poinicr to ihc <iuui of a block ol' memory, 

' Number or hyies lo move. 

' Bank of Btki (0 = hank 0, I = baiik 1 ) 
' Bank of fiiK2 (0 ■ bank 0. 1 ^bank I) 



Kclum: rO-r.l unchan|EcJ 

This ri>uiiiw vjinplyloadft Y uith itmctoaieakhDoBOp. 




TOIH 



CftAMC4K 

DOUBLK_W 



S40 
94tt 

l«400 



O»_40 


- 


atijo 


• MO 


ucamKnaiM 


- 14 


INFUTtlt 


• 15 


ICIYHBt» 


- 35 


KEY ALT 


> 26 


BY&SC 


- 27 


KMTfffttmL 


■ 7 


KKTKKTER 


> 11 


orriZBrtAQ* 


- f < 


tOUafB Yr EM I DTH 


- BO 


•cmmiPixtijriDTii 


- MO 



ua« th*»« two to t*at 



disk «rror 
ijaput davic« 



:9ttmmt Into h«Ad*r block 






lABLKi 
/Vru' Fifuates, VariaMrs ami Omsmnn igtmtTSSym) 



Tablo 






AccsBACACba 




- ftcZof 


ColorCard 




- Ic2f3 


Co 1 o r ll*ct Ang 1 « 


1 > tc2rb 


DoBOp 




- »e2oe 


Bid*OnlyMouB« 


- Sc2f2 


J^IadX 




- f Mao 


Hovaaoata 




> Sc2>3 


■oaallMK 




- (c2o0 


■■tColosllDdi 


» 


■ $e3r5 


SatHaaPlc 




■ Sc2da 


SatMMiModO 




■ fc2dd 


SiiapBOata 




« $<!2«4 


TBfiaiitrtliinii 


• Sc2d7 


VorifyBData 




■ $c2m9 


; Varlabloa 






«raphModa 




t003f ;b 


•ertOPolflr 




titbc 


aeriOCoioti 




li»bd 


▼decitfioda 




laaba 


k*yrftg 




M02f 


elkvvg 




$d030 


•■u 




$d500 


VDC 




MCOO 


Mooanaas 




ffdOO 


MDHooaa 




»f«BO 


eoAfto 




Iff 00 



;oopy of V1>C Kog 24 
;cuFrafit color aoda 



; Conataota 



12000 
#20 



Hdiforiai \oie: Ihr Tramaciar disk for this issue iTdisk 927 i 
wiU im hull- f^r4n!2fiS\m, Alst> ^orih mttint: at this lime is the 
foci tiuAS iifue 9:i fH/uru / iUited thai we n^mU Mppart /tit 
format), ait tubmhuom reeeived have been in iieoPn>itram' 
mer formal. tAithoufth hriimix Kostelh ^tnt to the trouMc i^ 
makinx his article for this issue PAl-compatihle.i Conse- 
ifittttih. rnini armies wiU he in ^eoprogmmmer formal ustrtfi 
ASM iaheh and symbt*is. Generally speokinft. an article will he 
pMished in the form in which it is received: artd that form 
will most Ukety be geoProgrammer. - MO 



NOTHING LOADS VOl R PROGRAMS FAbILK 

THE QIICK BROWN BOX 
A NEW CONCEPT IN COMMODORE CARTRfDCES 

Store up 10 30 of >our fAvoriic prognai — Batii; it M L. Gamo St 
Tiiliiic^, Word PfLKciiOfi A Ttnniiiab — iaa imglc bailcr> -backed 
carlridic READY TO RUN AT THE TOUCH OF A REV. 
HUNDREDS OF TIMES FASTER THAN DISK Oiinfc coniemi 
aa oficn Ai vou Mith. The QBB acccpu moat unproiectrd ptoBrami 
mcludin|[ "The Wnie Siuir the only »ord pruccwir thiii Mom >our 
(CXI Afr >ou type. Utc ■■ a petmaocoi RAM-DISK, a proiecied «orL 
afta. an auloboot uiiJjty, Includes utdiiiet for C64 and C-T2ff mode. 

Packaae% avaiUbk wuh "1 he Wmc SiuTT," ''UUniicrro UJ." -QDuk" 
(CP< M RAM DukK or QBB Ulililiei Ditk. Price: 32K S99:64K SI29. 
1+13 S H:S5o\'er^a.\aLt. Mau re^idcni^ uid yn I Year Warraniy 
Brown Bonn, Inc. 26 Concord Rd, Betlford, MA 01730; {i>\7] 275- 
0090; ^tl-MS 




paaa thia to SaUUaPic 



Ttomoctor 
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Loadermaker 



Easy GEOS info sectors 






by Nicbcriftv J. Vrlh 



Once you $c\ the feel lor it, coding ttuciiiblcf for GbCK> is easy. 
The itHJtincs «ft prrtry easy to accesf, and you can do *rf>tnc 
pnru> innmrs^ivc ihing^ *iih juM one subrouunc call. Hic 
prohtcm ift ihtl during a dcvclopmcnl cyde you end up avsem- 

bling aiid icMinj: ihc vinic pn>L"ijni n^ci .iiwi over Thi^ pro- 
ceiM can gel Tnc%^> iuhI inLLKiVk;iiieni if yi>u have a program 
like PKcnfMiHjs fn»n» Pie Offivial GfO^ Pro]inimcr'\ Hcfff' 
fiitr Guidt. 



The iroubk- js (lui i>iKc >ou cnn\cn u file toQBOSfonnaL >ou 
jpuaf delete It ^^ith CrMis. or you end up with a ^ccior ulloLated 
in ihc HAM hut noi tied to an\ program (bewauM: the I><>h 
scratch doesn't know about Ihe UbLUk inJb MXtorj. (I you arc 
like I am, when vchj aa- icMinp an aKxcmbler pn^cram (particu* 
larly if you arc jum learning (■i.us), \o\i Ircijucntly hang the 
system up and need lo re^ it. So to put up a new version of 
the program \ou need to Kxii up r.tos. \4.-rjiLh the old pro- 
gram, then boot up your a^\e1nble^. change tlic source. 
n:a\scmbk\ and reN^rt vaus am! nifi%crt. Rnally you pet t(» 
lesl your change! Witii Uk ^ariou^ cop) protcctiun *^Ikiiivs 
rnvohed tn geos and your laaeaiMer. there are a couple of 
disk -^wap^ mvoJved in ihc pmcc^a- 

Loaitrmakrr was wrilicn becattse I am lazy and warned to 
kiiorten ihc procc&s. AU Loadcrmaktr duci u create a UkMi 
OSns privjTLiTii whose m>Ic purpose i^ To load a non-GEos pro- 
grunu and ^lan it running in ihc *ii <>\ cnvjronmcnL Sin*.o rhc 
loader pmfrram doesn't do anything except load the piogiuin 
you arc icMing. there l^ not a lot <if need to change it- Since ihe 
test program \s a normal Commtidorc fik, you can use your 
avsembler ;ind wr-itth. nrasscrnblc. etc. to your hc:irt\ cnntcnl 
wMlOui colJccung cxira OLOS into secton». 

Opcrjiion of the pnigram is pretty MraightforwarLl, TX>ubtc 
click on the icon lo get it running. You will get a menu with 
Ihree options: 'Done' will get vtHi back to the lX'NkTi»p. 
'Make' iktanft the procc*^ and 'Help' ^[^iic.s a httk cxplaiu- 
tion of the pn»j:ram purpoM.- ;«u! (^ratton. Selecting 'Make' 
will pn:scnt you with a window whicli a^ks lor the name ol llie 
program you want the l>ooi program to load. Thift should he 
the tumK ol \our a^^en1bler ouIihjI, It docs not have to exist ui 
thi« tinK. The second qucMion is the name for the bout pn>- 
grarn which will do the Ituding. This is the name of llw CEOS 
pri^ram vihi will double click on to gel your program loaded 



and run. II this file already exists. >ou will be asked if you 
want it overlaid with the new version or not. If you click on 
Vl^s. a new cop> is wrillen out. If you click on NO. then >(hi 
will be asked for a itew name for the boot loader progrum. 
That"* il. You will go back l<» ihc main menu to eiihcr quii or 
crcAte another boot loader 

The operation of the boot kuJcr program generated b) UtaJ- 
ermaker is even simpler than hHnirrmttker. All you do i* dou- 
ble click on the icon, and you are off and running: wuh sour 
assembler program. The loader runs out of location )7N0, m) it 
will noi load a program to thai aiva. It uses the load address 
iound a& the lir>i two b)tes of die avxcmblcr tile u la ni>m)al 
load **.-*' Al)- The ^anfnp etecution address is assumed to 
be the same a-s the slarting load adda-ss. 

Since hKuhtrnattr is such a simple GEOS program, il alio 
makes a good sample ol liow lo code one up. ^ hik :»iiiiple, it 
uses most of the baNic GEOS processes (menus, windows, file 
lAJ, etcj^ I would recommend two soukcs ol mtomiation on 
GG05. The first is a shareware manual by Alexander Boyee 
(226^ Grandview Ave.. Apt 1. Cleveland lIcighl^, oH 44106- 
3144. or check your lotal BBS). The secomJ is Thf Offuiai 
GEOS Pmnrammers Hrferrncr GuiJr by BcTkelcy tBanlam 
Computer BuuLa/. The latter vs a littk more complcic. but ilif- 
Hcult to read and find things in, l>ie former is much easici [u 
read, and belter indcxed^ The IjHiJfimijkri program is a miX' 
ture. The routine names arc from tto>ce's manual, and the 
Page Zcn> Jcrmiiions arc from ihe Berkele) manual 

Most of the pn>gr:im Is a piwe^* of xetling up Page Zero regis- 
ters with piiinicrx to a table, callmg a tii-.os routine to d^j llic 

work, and then checking the results. I won'i try to esplain all 
the i»piuMi> used m each I'l ihv- taMcN, Hither of the maniuK 
menlioned earlier can do that (and Tve included liberal com- 
ments in the M>urcc \. What I h r// do here is ptjint oul some of 

the tiling?! which aren't reall) meauofKd in ihc manuals. 

One «f the hard parts of cms is designing a text screen 
(believe it or noti. Mikc all the text is proportional, you can't 
just count characters to decule if ihc> will fit on a line or in a 
box. 1 u^ two diffcit^nt mcUuxls. 1-or small areas such as 
menu options :ind title line**. I take a gueaa and then make 
adJU^tmcnts uticr I sec it un the scaxn. Note that when doing 
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iwciiu i^tionv < I ' >s liiKcs caic of the dividing line txrlwccn all 
the <iptians, loull you have m do is worn jKnti the widrh nf 
ihc boK area. If you Uun'i dUow cnuu^h muiu, Citoi jjcrs con- 
ftiied and. when ymi vicct thai cnliy, ii rev«fit-inmgCN more 
tfian ri \h(Hild. Other ihjii lotikin^ tunny, it woriu for IcsUiij. 
Lmm^s up suhnwnu* i* really a chaMcngc, s'itkc the dividing 
lint i« put in by atcs. Air^in. lAc .1 ^ucftsandadJuM aflcr you 
ICC il on Uk: svrccn. Aftcf a while you can fct good enough 10 
coum AcHs on the screen fa loeen dot is one pixel). 



TTie ibecond method of figuring oui what *i!I fit \\ the tmc I 
uw for larger airax (*uch as the help window te\i>. Thix is 
more cuinphc4iLed. 1 do the icxi in fifoWrife, with the maigin^ 
pulled into ihc size of the area I ain working with. That way, 
gftMnif will tell nic what fiLv und wrap the linc\ a*> needed 
ihn your information, the standard ipannp between lines used 
b> yriAVnu- is in pivcNi. There are a lot more 'moving parii" 
this way. but ii docMi'i lake any longer than if you just tried to 
guess and adjust each line as you go. 



I rrcommerul using holding foriMMlkort text. Plain BSW font 
iihc ilcfauh font) 1^ a little hard to read. You should also note 
that if you have a pattern ihi the screen and put text on it with 
ten pixels between lines there will be one pixel of [uEtt-m 
shoaling between must Lharacicrx, but nine pixels between 
causes the tops hthI Nmi»ms of some letters to louch. There* 
fon.'. I rcLomnK-nilpiiihng icM oji a plain background if posM- 
We. or line it up with your pattern (patterns arc R ptxel% high). 
I also recommend ,1 spj*,c before -irul jHcr any icxi which is 
put on a partem. Oilicrwtsc the ftrtt and last characters of ihe 
lexl mn into the pattern. 

Multiple linesof text ina window arc sort of tricky. A carriage 
relum ^decimal 13) lakes ytni to the sian of the left maiBin. 
aiKl the window processor sets the left margin to 0. Any text 
posiiioninj; controls arc in reference to the left margin, not the 
edge of the window. Since the window procenv allows mullt- 
pic text references, I would recommend this nuihod for nH»st 
»indo^^.^ i\u\ need moTC than one line- It iakc^ live byte* \his 
way (one control, three coordinates, and one allhe end). 

An altcmale nwthod iwhith I u^cd for ihe window text) is to 
use the posiiitming conirok within the text and ;idjuM for 
where ihc window will be. Tbi* only takc& four bytes, but has 
the disadvantage of needing changes if \ <ni move the w inflow . 

A word of caution on lexi: if yoit forget the Oat the end of the 
text, you will usually gel a wyslcin error anit'or lung uputos. 

h Is possible lopoxiliiKi some things klii.k Nixes, text, etclso 
ihc> hjng outside the windt>w. nil*! icikb to Itio^ up ytnir 
screen, since the window pnxrc^sor only recovcn d*e pcvtion 
(*f the screen defined by the windo\\. and it wiU leave the stuff 
which hung over on the nrrcen. 

One final poim about tcM m UEu^i, GEa& ases true Ascw 
instead of Oommodore ASrtl, This means ih^ii most Com- 
m^idorc assemblers will base trouble uxsemblmg dii> ihui^ udi' 



Tionsoctor 



cr than lower case lent Mrings. i minlilied SVMASS with a new 
pseudo opciHlc, ,TASC, which tcits swLv^s to assemble true 
AM-U characters instead of Commodore AWlt, 

The finaf challenge now become*: how do I assemble Unxder- 
maker with SYMASS, and make it a CiEOS program *o I din/t 
have to mess w iih making geos progrann for a while again, 

ALiiially, then arc three ways. If you have already OP^ iti 
l-ki. roGEOS fftmi the Berkeley Book, then all you need to do is 
take IjMiJermuktT, iissemble it. and use a convenient mi mimi- 
tor to save the object cikIc to di^, Ihcn ju« run rkuimjEOS 
against it. The source for JL/W^rmtitrr is sci up with thctims 
info sector on the fumt whea- i-ki.Hk.lu^ expects iL 

If yoo have not typed in rm.HHihOS <ot d*in'l have the lUrke- 
ley Book), then you will need a haiuly sector editor pn^gmm 10 
perform some mirn*r disk magic. If you are going to do this, I 
sntmiiiy retommend that you start with a disk that doesn't 
have anything on it that you want fprrferahly empty). You will 
K- a-wnting directory bkvks. and it is [xissible to make a mis- 
take and mess up the disk so that you cannot acces<f anylhing 
on It (not likety. but p<isMble>. 

Rf^, asseml>le l^tadrrnuiifr and save it tnil to yov tandl 
disk as J nomul Coinmodorx,- I'Rt, file with a eonvcnicnt VIL 
monitor. Then you need to lue your sector editor to find the 
directory entry for Likiiltrnudtr. The directory is ai track SI2, 
sector SOI. If you started with an empty disk, the LoatUrmakrr 
entry will he the first rand onlv 1 entry, li will sum with a S82, 
the siartmg track and tectun and then lih: iluiic. You will need 
to write down Ihe starting track and sector number (this will 
be^jome the otos info sector), 

Use your sector editor to read ihe sLirting tiacfc and iedor. Tlie 
lirst two bytes of thi& M^ctor arc Ihc track and sector where the 
Lnadrrmakrr <:odc starts Write these numbers down (they will 
become the program suning sector). Ihc third and fourth 
bytes tcll w here the data was saved from f <.hou!d be S04 $40, 
You want lo change these fmir hsu-s to S<K> SFF U)y S15, and 
write the acvtor back to disk. Next, you want to reread the 
directory sector thai had the Unuhf maker entrv tn it (512 SOI 
if Ihe disk was empty j. Slanmg at (he S82 in the UmJcrnuiker 
directory entry, you want lo change the S82 to $83. then you 
wani to change the next two hMcs to he tl»e track and vector of 
the paigram suning nxior you wtoie down from before. The 
name p<irtion oi a dtrccti>r> entry is always the same length, 
and Ihe name is padded wiUi ^lulled spaces (SAO's), Immedi- 
ately following the name, you want to enicr the track and sec- 
tor numbers of the info sector vou recorded previously. Fcrf- 
lowing the info sector, you want to enter the following five 
bytes: S0() $06 S!?K SOI S()l. Rnally. nrwnte the directory scc- 
lor back to disk, 

A thini method is iIk- one I use after 1 have tested a iww pro- 
gram and want to make it into a normal GEOS pnigTvn, I just 
"Mear an info sector Irnrn another (JFiW pn>gram. Again. I 
urge doing this on an empty disk - just in ca*e. What 1 ^ is 
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copy a ctit^ ^io^i^m thai ha^ sn info tccior similar to what I 
*an(- Then I pinnl lo that scvior j\ the iiifn wctcw oC my new 
prugmm. and fix up ihe l«Mii .uklrc^v etc. (inally. I boot up 
G60S and Uah the copy I look the inro %cctor Imm, I ihcn use 
(-MIS to validate ihc dbl tbcuuiM: it ha» «cmchcd m> tnfo 
^cctorV Whilr thts ^nunds sort orcompltcaied. I don't have to 
do it enough to nuk^' ii ^^nxh m) \^hilc li> h(i[hcr Keying in 
PRGTCXlEos. and having to key in the info sector for each new 
prnjrnjin. 
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An Introduction To GEOS Files 



Using the high-level disk routines 



by FraiHi^i;. KirsUlla 






While coding m> first aflcmpli al 4 working UEjOS projjraiii, I 
was Dvcruhclmcd - and more than a linlc cnnfusrd - at fhc 
iccmin^ ci>rnpkMi> of ibc CEOS kemaJ. Afier uJI. ihcrc arc 
mlmo^t 200 callaMe routines and hundreds of vahabkv 
tvallabtc to ihc prn^rammer, and I hi'lu-vc I've had ihc i>ppor- 
lunit) 10 um: must ot them the wrong wu^! Bui ii bit uf pcnU^^- 
tencc doc^ pay off and, after a while, ihe MnMun- hepins to 
mike sense- Whai once MVUK'd hit- hiH>p\ ui he jutntwd 
ihnHigh became simple meihinls <ir iKhiev mg compleit results. 

My fin.! few pn^gmm avuided using any type of dulc acccu. 

excepr to exit the prt>j:r:im ami TvU\ii\ iht- !5e\kTop. Bui laicr \ 
becwic a hw txiJdcr and decided u> take a luoL at Uic do^m. ol 
disk ^tHltine^ available and tiy to use them in my pn^nims 
Ibi-xidcs. nn projiranis \. urimj: lo cat up all die available 
memxy and I'd have to loud and !vave sections 10 di^kl, A flrsl 

glance in The Offniai iitO\ Pntaramrrifn Rt-frtctu t- Mttrmat 
fiwn Bcikcley Suhwofk^ stkuwcd over SO disk rouiincH 
available, so I prefwrcd myself to write a number of complex 
setup roulmcN aJid lo do \}om\ of dcbuj^i^m^. 

Well, m> first efforts failed niiscraM). but lunhcr Niudy 
showed Uui 1 W4S using too many routines. Looking buck it 
seems 1 was tryilljlousca*nun> of ihc ;i\aiLihli' munncs as 
ptKsiblc. when i>ik or two would ha\c sutfkcd, liiv ^^icai 
majority of the disk calls arc the primitives thai male up the 
higher level muiines [hat Uwd and sasc \l.Jk and (^tos itQ 
flics. 

Loading a file 15 easily acLomplLilkcd uncc you have the Jik- 
name, and the recofd number if the file is a VUR file. To loud a 
chos SEiyucntial structure file, we simpl> put ihc address ol 
the miU-lerminaied filename siring into the zero page register 
r* (Snr^Fj, store j zero in rO iS02t aiid then JsR lo m :<IH 
[GV/fi/e (LUAU)l. 1 Ihruughuut this aniclc. aiHJ in the prugnim 
liMing, the hex address of the muline is used, followed hy the 
Bsw Uhcl and the Bo>ce label.) The file is loaded Lo ihc 
addrcsx m xi\c file's Header Block. If we want 10 load the file 
lo a differeni address, we sUmv ;i 1 in rO. and \mi\\ ihc address 
to load in r7 iSlWl 1). FilenaiiR-s are easily obtained from disk 
or from (he user with a dialog box (see the example program j, 

If we're trying to load .i record from a vi m file we first ofx-n 
the file b> passing the pttinier lo ihe hlcnjiiK in rO lS»2^M) 



dicQ calling $C274 {QpettRtiordFih (vopEN).t Next wc pass 
ihe recitfdntimber we want in Jkand ivK 50280 \P,»intRrtont 
HA}U)).\ Wc nr now poiiUuig at Uic record, 10 load 11 paas ihc 
load address in r7, and the number of bytes expected m rl 

^WiA»7* I injll\, jUci Ihe revirtd is read in. ussuming ^*e"re 
diHK icodmg itxordsi we close the file with JSR $C277 
inos4'Rrtt>rtlFilri\i\()St\.\ 

To save a file of any type, we need to cfoue an aita in 
memory thai will be saved lo disk as the Hcjdci Block 
aiiathcd to the file. The Header is 256 bytes long and will lell 
the save rouiine the file upe, file structure, load addfL■^^, cu.\ 
Exact dcs(.nptioiu of the structure of ihc Header can be lound 
in either Alex Bo\ce\ manual <w the ftsw \nn\. hut llviv arc a 
lew b>tes well use when saving a file that should be 
explained. 



When Ihc Header is written to disk, the first two byies will 
be replaced wilh VK) $I-T to indicate ihai ilic cnMre sector is 
used and no other, but while the Header is still in KAM, these 
two bytes will he Ufted 10 point to a null- terminated fikname. 
This is the name thai will he used ui ilic hle'sdireclory entry. 
A few other bytes will be used to build the directory entry. 
B>le f>8 in the Header will hold the normal lK*b file l>pe 
i usuaU) &K3, Ibtih Byte W w ill describe one of the Gtajs file 
tvpes (font, application ilat.i, <fi\k .Kcessorx. and so onl. 
B>ie 71} will lell us iJw Gi£OS file sUuciurc. 1 for \UR and 
for GEOS si:<ji hiNTiAL. The neait two pairs of byics are 

-iddrcsses: 71^2 is the load/beginning address, 73/74 is tlie 
end address. 

1 o live an mm of memory as a cnos seQUoniAL file, wc sei 

up the above menitoned bytes and addresses, load the address 
ot the Header into r* ($14/15), put a zero into rlOl iil6j and 
call SC]ED[5<Ar/'f7^fSAVE)J 

T<i save a VLIR rccofd. we muM fir^i create Uk file. Call 
SCIRD as above, but set the beginning address in the Header 
to MM Km jj.j Ihe end address lu SFFFF. (If Uk \ur fUc i&an 
executable file, put the load addrcM of the firvt record into 

Header Ktes 7 1/72. the load ^idtitessj into 73/74. jiij the }\U' 
addirvs into 75/76.) Now we have to create the records, first 
o|vn it. call $C289 12^ limes, ihen close the VUR fik. like 
Ihis: 
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)Br tc28d , ftpp«ftdr*oocd (append) 

biM aloop 

jar $c277 ; elos*t*cordfit« (vclostt) 

To write a rccorxl. select the record by calling $C280 
Ihn'tlRttitrJ IcxiUMl wiih the rcvord number in .A. pul ihc 
befirminf lavc jdUa*ss in r7 (&I(VI i > and Ihc number uf b>tcs 
to^vc inrli^fKi/07)and;sw Sr28FIUfiVffcco/v/(vsAVE).I 

The npos disk rmitincs do iheir own error checkinj; am! UMial- 
I) return emu iiiiniK~r% in \\w .\ rvpswr. I smg ihc :itx>vc tou- 
tinei for simple loading and sdivmtt. ihe only error Tvc hod lo 
deal wiih i\ •! I: record cmpl>, \fchcn aileni|>tmg lo to rcml u 
Doncxiucfil VL4K nxurd. Of gouimt, moic complex applica- 
tions will warn nuJTt elaN»nifc error chctking. Sec the ^M>ve- 
mcniKincd pro^rjnimcr s rclcrciKv ^uidc^ fi>t inorc dcUuK. 

Anofhcf ihin^ I slH>utd nKnth>n, is ihm Lhc ubove roiitirMrs 
a^uinc Uuu >uu arc ik>i duuivin^ disk deviccv nor tuapping 
disks. Changing driven is accomplished h> calling SC^BI* 
ISttOi'vuv (DRV&in^Jl with the device number ui .A. Thi» 
should be followed hy m ca!l to $C2A I {OprnPid fop\tViKH 

Mhuh 1^ <dM> used to rc^ n nc^l) inscncd disk. I hcsc two 
routines, when uvrd. should he culled before using any of the 
load or save rouiirtes detailed .ibove. 

ANmt fhr pnJur'uitK 

Program 2, iam Drpner will ininslafe a phofo from a Photo 
Album iruo a form readily digestihle bs viHir assembler. I use 
this pmgram to 'grab' my compacted ic*>n drawin^r^ from 
^'toPaini for ux in nn projirarns, In fact, the itons u^rd in the 
program were tmnslalcd b) an caflJcr version of tlii^ program. 

\ few notes: The fir\i three byte* of ihc gniphtt arc Uic w iJth 
and height uf the bitmap: voti vht^ukl delete them or commcm 
rhcm out ;i^ ihey will inlcrtcre with the ciltis Linvom[Ucimg 
luuuitc^. ALkO. tlic liM lew byte^ are the coluui iiilonnauon for 
the bitmap. If you have a copy of the BSW PRCi. \cc Appendix 
D. irthcrwiMT. >ou can Ica^c llKin uu or culcuUc llicm trum 
the width and tKight b>ies. 

The rcvuliing ,suj file can be convened lo a PRO file with Pro- 
cram L which is from an carhcr Tmnxattor, If you'n: tnn?blat- 
in^ lots o1 icons, um: the LXJb cunuiiaiid CO: to concaU:iuUe a 
jrnup of SEO file* lo nave time. If you'd like to have a nrrw 
Hcddcr attached to the iiutpul file, clian^e hvic b*' lo S. llic 
pr\>gram i« cuily modified to accept differrnt input and tnitput 
files. M> experiment. Td like to thank Jtv Buckley fw explain- 
ing uj me the um: uf the unducumcnlcd ruutJiK AiypettdR^tord. 
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RAMifications 



Approaches to fattcuin^ the CI28, 
with critique and comments from Paul Bosacki, 

who did it for the 64 






by Kiehard Curckt 

Piul BtiN;ivki\ C256 (V:>liiinc 9, Usuc 2) i\ ihc imisi eliciting 
hardwatr pmjcci for the CM to come oiong in a long time. I 
offer a bit of advice to otherN who v^ould nxKlify u sjluiihle 

piece of equipnicm: 

Don't plun on rc-usin^ chlp^ dcMtlJcfc^ from cquipmcni. 
Often, the efforts to remove the chip intact result in datnage to 
the circuit hoard. If the ic is \ucce^sfulI> renkived. one can 
never be 100% certain of its reliabiliiy. Without acce«\ to pro- 
fessi<>n;i1 iU"M*Mcnnf; ci|ujpmcni. il\ better lo plan on discanl- 
ing aji> iciuoscd chipv lldvin^ nuik this decision, chip re- 
moval become* tnuch ea^^ier. 

On the solder tide of the circuit board. MMitc pinv may be bcni 
ovtf. Straighten ihe^e hy heating uirh j low-w j[t,i;jc soldering 
iron und slipping iJk bl4idcuf ji&mjill>;t^ciia'^M;reudrivcr or 
a hobb> knife (X-acto) bctw«n the bent-over ponton and the 
PC board. {Jhi^ Mcp in cvscniiuJ if you do decide to rivL re- 
LKtng the chips.) On the component side of the KuTtJ, using a 
sharp, stnall diagonal cuiicr. ^Iip ojch K pin a% ck>M.' ;is you 
can get lo the body of the chip. 

Once all ihc pins of one chip ha^c been clif^jcd, iod the body 
discarded, begin de^oldcrinp the pins, Heating each pin from 
the hoaiwn of the hoard, mosi pm\ will smipl) drop out of the 
hole. Those that don't can be rrmosed from the top-side. Grab 
each pin uith small needle no\e pliers or Iwee/ers v^hile heal- 
ing the pin t*iUi the Mildcrmg iron. With rust a few jiggles, ihe 
pin should come free. 



u-<c a looih-plck or fliaigtened paper clip lo clear the no//lc. 
A hhaipcitcd wooden tooth-pick is al\u useful for clearing iHil 
the (\' board holes. 



Doiible*s>dcd primed circuit boanb (circuit traces on both 
>idcsi use "pbicd-lhrough" holes. In other words, the inside 
of the httle is clipper clad to continue the circuit fmrn one side 
of the bitard ti> the other. If an> dcsoldcrcd componont lead or 
IC pin come!i out with a small copper-coloured cylinder on it, 
the throuph plaiini: has come kx»\c. I'sually, soldering l!w 
replaccincni part on buUi sides ol tin: bo^rd \^iU restoa' Ihe cir- 
cuit*% continuity. If you can't get to the component side of the 
pan isLich as the umterside of an If socket. I flow jusi a iiirte 
more solder than ncxcssary from the bottom of the board. 

You might want tu practite dieae technujue^ before majiglmg 
vour rmstv CM, Most bn!e cities have an area ttiat used to he 

kno\in as "kadio Row", wlKrv oik can purchase everything 

from anrimi teletype machines and nntar tmnsmiiieis to obu>- 
Icic and/or defective consumer electronics. Pick up a fev* junit 
circun bo.irds and it> your hand at removing ics. 

k_VMilkaliuiW At C128 

There arc a number of possibilities (with aiicndani diflKcak]c^T 
in performing a memory expansion siiniliar to Paul Bu%acki't 
on Ihe CI2K. Tlu- rollo\\in>: is ilic result of many nights spent 
!btudMng the CI28 scheuuiiLS and Is intended to stimulate 
*ome debate on the subject. 



Clear out the hole from the vdder side with a *'M)ldcr sucker". As many functions a« is reasonable should be controlled by 
Radio Shack carries a very itK'xjHrnsivc one. The trick v^ilh *oft\^arc, \siih a few key fuiKiions controlled h\ s\vii^.hc\ that 
ihe^ i^ to keep the nozzle clear. Iimpt> the sucker often and ovcr-ndc the solt^arc ^cmngk. There u ample Hi spA;c fur 
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"I adding laidic^ oiiJ ^uch without u^ing the 'ofTiciur vo loca- 

«itof\s. At leaM part of rhcjdilcifniemof> should be ;i\.ii!iihU- in 
W nuHlc LUid bccinii|\mHc \^*lh Mr. [k»sacla\<lc%i^ 

Wiih iheaecriwii in mind, von^jdcr these vu^csiums: 

Kqilace the MK of RAM I wiih :56K chips, dividing 
RAM 1 mki^ub-Uink^'. 



In \2^ iTUHle. ^c nfcil noi \m: eontemcd wjih the UK;ilH>n and 
iDioum o1 common kam mikc h\ alwiyi in RAM o and the 
Mvit will ukc care of cvcr>thin£. Pin 47 ol the MMl , van- 
ousl> referred to a^ Mbj ur cl2H. goes tu Ui|fic in 64 mode, 
disabling the favi serial circuiTn jnd signalling the pla to as- 
susuc U\ CM perMina. ilijs can be used to disregard R-\M u and 
twitch over lo the expanded RAM I m M nifxle and eoible the 
■ w\M ciKUjrr> that would be needed, Mncc ihc MMt effec- 
tively vanishes, 

lii'^^cvcr. wc would lu^ the abiiu> to have ftuiiiclJiuig m 
RAM he present when we switch to 64 mode. If we anempi to 
make RAM o available. aJon^ with the expanded RAM i. in M 
mode we then have five mk bankv ■ a major (neomp;iiibihty 
uiih Mr. BouckiS design. 

2) Replace bt>th RAM and 1 with 256K chip%. crralinc a 
C5I2! 



5) Donoihing. Wait for Commodore to produce the ClOnO. 
(Dtm't hold \our breiithj 

PerMMially, I am inclined lo go with item one as a plan of ac- 
tum. Memory i% increased by ]*X}K to a u>Lai of 32oK- Dcalmg 
with the difficultie* of item two may require an Inordinaie 
amount ol logic. Imtiallv item three mcrciv d*»ubles the 
amount of memory and requires even more 'outboard' clec- 
titmicv 

There are numermi*; deliiK to he woflet! out in implemcnthig 
an> of the abmc <cxce|H for item 5i; What is tt»c dilferesce 
between Ml X. which doeMi*l enist in the CMS old Vic chip, 
and CAS? Shoutd the new cram ctrx.uiir> loi>k al ihe proLC^sor 
addrcu bus, or the inuiUalcd adda^^x bm? How -^kmld the 
pirconfipuratton regjuen be handled, if at all? How should 
evpunded mcnHH> behave m ZHOmodc? 



With cn^nigh 

h iipnctical? 
Uialugue 



re. afi>thing i^ possible. Tlic question ii: 



Th§ fofhminji text h iukrn fnmi an cuharifn' tjf ItMn bf- 
rH-rrn Mr Cwrio atuJ Mr. Boxacki. Mr. Cunio. like Mr. Bo- 
Micki heforr him. ha\ iinJty ai^rftit ro ihe puNuatntf of hts 



Besides the p^'fCMilal for damu^iiii^ (he eitLuii K*jfd b\ dc&ol- 

dcnng 16 MXtccn pm chip% (thai s 2^6 pms. loik^K we have to 
dnphciitc (he < R vKf actions of the MMl . There is no signal 
Uynn ihe \LML lu indicate that comiikon RAM i^ bang accc^&ed. 
The task ii to capture the common ram «noum ami Uva- 
lionuj values wntien to tik' RAM configuration reiijsiei' at 
SU3U6 (not overly difHcult; SD5xx h already dewiidcd). and 
qualify our cram enable wiih the CAS iituiuicd (oi k \m *k ,\p. 
propriate duec-stalc circuitry, controlled b) MS>. could allow 
ihH mod to mimic Mr BcaackiS tTUHfifKatlon in M mode< 

3) Add two A4K banks, comprised of four ft4Kx4 [JRAMi, 

In addition to capluna^ Uk CkAXt parameters, if we al«o cap- 
ntrt hit 7 of ^FRMl. we can implement the misxing Kinks 2 
and 3. >^ hich the Liperating s> stem alrcad) knuw^ about but Ihc 
MMl and the rest of the hardware don't provide. Only mim»r 
altiTJiions need be pcrtormcd on the CI2S n Kurd More 
RAM could be lidded at a later dale. The hardest pari may be 
gelling II all to ftt inside the case. 

4) Don't add any ram, Insteml, make ram i. the second 
coloui nieinor) bank, and pyssibi) tile la^t Mcrial circuits, 
availabk in M mode. 

Ihia u pretty simple. Conmnnkxe could have made this 
avaifjhlc as an 'enhanced" M modc.i When compared lo a 
C25Fi. this it pitit) iiwagre lare. and nia) nol be worth the ef- 
^■^. On the other hand, the eaeidae may be useful as a prelim 
mars hatk. 



I applaud >our accompli shnieni. creaim^ u Ul Cb4, 1 am eager 
to know Ihc details of the 5 1 2K expansion. If rl uses a switch 
lo s^-lccl Ihc stxond 2_^ftK. \*hi mighi Iv interested in J-i^un: 2 
cd the cnclOMfd wlR*mjiKs. I am told thai your mtxlirtcation 
doeMi't work on the newer 64Cs. Can >ou conOrm this or pro- 
vide a fix? {Happily \tn Bo^^iu Jtas oUtauwtl un L-hourJ 
f>4C ami SUnrj that the mtkl utn ftc tnhicvril in that niachine 
aho. -Etij Also, how jre RAM-based characters handled b> 
your circuit? Doe* Om/ittttrr 256 wort with ^^oFomtl How 
can we implemenl ynii (.M*s iiuhI wiihtnii the Ulleged) bcrw 
fit iji OeuPrvgftimmer! I am not a Jan of Gfeos and if you can 
provide any tmprtnements lo it (like luniinj: ofT propt>rtional 
stpacing in text in atoPatntj that would be ga-al. 

Have you consitkred the posMbiliT> of a C128 evpansjon.' 1 
have a few ideas regarding that, and it seems that there are 
more than a few difTiculties ro o\en.on>e. 

I had heard alxMJt your Cl% some nv^nths hefoit «eing it in 
TnwiihU*'. While a^Aaiiini: ilkii issue. I demised tv>n paper) my 
own method for ram expansion, 1 don't know if it would work, 
and I admit that my knowledge o( djnamie RAM is somewhat 
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) ourv It v^oiiiil fit lusiJc a C(>4 but pmtuN> ikK a 64C. 



BaMLall). m> \4hc-nx' lE t^ufr h, wihjM ic»vc the original ram 
chip« in place, ami ilivcn ihc PLAS CASRAM ^gnal from ihc 

4 IMn ro Ihc cn.ihlc iif a 74l.si ^^ or \imilar dccivlcr ()i»e tkvi\lc*l 
output gi>cs lu the unboorU nHmKK> i.hip\ and the others ^ lo 
hanKxofiJW^rMK x 4), The value on iJk- *kxttder\ v^kvi Siix 
diTtcmiLiKs Mhkh hdiiL gct> CAS'cd. (A thrtx-bit decoder n^ouM 
provide H 64K 'hanfc^V) Any Common R\M or Bank Fn;iWo 
signal would iorcc this value to sekit the onvmiil k\\\. 
Memory could be expanded in <tape«. am! the risk ui lUnajje ro 

the cia-uic board i\ minirnj/ed b> mrt ^k'M>ldcnni! am ^.lll|>^- 

On the other hand, ;i1l the data and \\ \ lines would have to he 
bnHJ>!hl m ihf expander h<Mid. UtoLing at your design. I gel 
Ihc uneasy fechng ihal mine wouldn't woric. Am I mistaken in 
j-ssimiinj; {\u{ unsckvlcd Kmks would Loniinuc to Ixr rclic^hcd 

A nusicr uhmS disable' ^wiidi ii a good ideu. I've gotten used 
fo \cttinp s^vliche^ in configure my virjo. but for ihe CM 
^wllche^ sccni like Mr\ciai Ntcp> t\kkv\ardv 

The fcanira I have in mind rnxd inoii.' Wws dum ihnso provided 
b> the iiasMTUc liik:.^ of the 65IU port, lu wjcatc niofv vu sptatx 
lo "i'lpply the necilcil hits. Figure 2a decodes Stl)\ enable { w hich 
occupies a x^asietul !K ot u>j, inui iour pages. OtK of Uk-sc is 
u«rd lo enable a t3C22 or other pamlfcl tnicrfaee chip. 




fisure 3 



Thi^ would power up or rr**t with its pnn pins high f \ fa pull- 
up rcMsiorsj and Ihc ii>gic would be such Ihal thi\ scleti^ the 
nonnal memory configuralion. S<>Iiware would be compatible 
ax loni; as ii dtx-sn't use an> SU) 'jma)!c' iulda*sses. Ihc f>H :: 
i« undoubtedly over kill lor this application uhc cvtos vcnkm. 
to reduce cuirrnl consumpliim. is als*? hard to nn*li. hut it's 
easily imcrlaL-ed and its other pmx miglu come in handy, per- 
haps for selecting aliemate ROMil 

The allcmati^c it lo also decode nm md phase 2 to provide a 
VkK'iW sin»be for a lalch and a ReaD Uv a tri-siaie buffer to 
read back ihc latch contents. Ilie lak:h should have a "clear" 
inpui %o that RESET provider all zeroes as the default 

The 65C22 would need U) be initialized, (>n reset, the pon\ go 
high because ihe iidks Und all t»thcr registers) aa- cleaa'd. 
pulling the pom in input iiiudc. Changing the mws lo (niltHil 
"cold* would cau** the pcm pins u> ^o low because the Output 
Registers were also ck-arcd. lonunaiely, the r>H:zz permiLs 
wnting to the Output Registers while connpured for Input 
Why isn't ihis a problem wuh ihc ^t^'^ p^»n?(Or is it?) 

Another wiy |o oNam more It) space is ^hown in Figure 2b. 
Here one of ihe ii\ cnabk's is aucaxptcd and decoded wilh 
A7 lo provide a new enaWe. I tend lo favour this appmach, 
aiuj ihc lower half ot ibc figure shows the laUh^liultiT aJiema 
tive to the 6SC22. If Bank Scleci remains al rhe 6SI0 port, 
ihnre of the lalch bits are unus<.*d and a\aiKihlc lof oibertrKkv, 

1 would like to have diffcrem ^mtnmti of common ttwi. per- 
haps as much a* I6K s*> thai a biliiiap al SJUOU Luuld be Mien 
from the other h3nk%. In Figure .1 the or gairt of your deaigD 
are slii-htty rearranged loproMde a logic i) when the lowest I, 
2. 4. or I6K ul memory are addressed, bits SO and SI of the 
74L.SISI data selcciw choose how much Am common ram 
will be present. Bu SI can ftwce the '151 to look at the pms 
held al +5y causing CRAMT. to be high. (The E input can't be 
used because when the '1^1 is d^sjbk^d. oui|>ut Y is low - 
whkh is Ihc opposite of whal's necikU although it could be 
used for a software 'mod disable'. » \\\i\\ no low ctmimon 
RAM, each bank could thu^ luivc itii ow n zero- page and slack ! 



Ftecause of the tcarcily of free ham in the loweM IK of 
memory. Figure 3 alto provides ihe capability of comm*>n 
RAM in high memnrv Three-inpui \\[> -jaic A, with Iwo left- 

uvennvcrlers. supplies TRAMH when AIS. 14. and I3an; 110. 
This de^<x1es addresses ^nXYVSORT a\ comm<in k \M when 

H enable is low. Ot course. D-block x,^ ati.c>sibk oidy when 

vn and character rom are switched out. Gate R repbixx Ihe 

two-inpui AMJ gale in your circuit, ll>e reniainuig OR gale can 

be used for a sollware A£C enable, (In your cinruil, how does 

an opt'fi s\*ikh translate to AEC cnahkd. since AFf tlocsni 

mailer?) Add invencrs a» iicccuary to provide ihe power-up 

configuration ■ depending upon .1 ftV?; pon with all pon bits 

at 1 or a cleaa^d lakh with all /cn>cs. Thai leaves one idle 

Ihnx-inpui and two 2-input and* for any other enhancements. 

In this circuit the anuHini of High C'ommtm ram is fixed, hut 

added cumplcxtiy could pnn idc variable amounts. 
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i^ifccn ihinp^ hccnmr too complex Uyc p;lIc^ and dccodeni, 
wmc niciin^ niusi be lound (o reduce the chip tuunt. I iiwludc 
1 dtfa \hcct for a L V criisabk PI A. This dc%1cc v^iis ^old hy 
Jamcco ;i \^hilc ago. 1 doni know if ii\ \U\\ j\aiUhle, Sup- 
piiscdlj- tbi^ ik\iiX could be programnKd m un BTtUM bum- 
cit7|, ir it doc*in'l come oui righl, emse it and tr> dpiin. I as- 
sume ihe miijiutat,iun:r can pfmide iihjn: inloniiiUioii regard- 
ing pn>i!rdmmmg» etc, 

E^cii MidHiut rcsunin^ to a humc-butited PLA. I'm ?airc ih^i 
lome of ihc above could be dmw nK>n: cfTicienlK- Rver\ time 
1 th^Hi^hi thji \\\i\ Jeiter ^ds Imi^hcd, a new idea v^uuM pikp 
into my head. Thank you for n mm! vttmukitin| pn^eci. I can 
!i"rJI\ ujiiio try this \tuir. 

Richard Curcio 
J!; Sc^eiilti Avenue 
BmoklmN,VM217 



Ihank you for your response to my article. TV big kick with 
Ihisunicle has ih>i been ^etling it pubhsh^d, hui riiihcr a-cciMn^ 
IcUcTN like >uu*v Ldlcn from people *hti underMand itw W4irk- 
iRftof the |*niKvt. My wife, I'm afr.ud. ha\ ^iXten a bii iin\l of 
hvann^ about ,vnu ^ik> dihl -CR/WI and "two biL cixk^" elc. 

Bui. on to your ^uesiiofix. Tlu; inoM inijx>rt4nt of which IK b 
Hie project comp;iiible with the newer M\, THe prelimiiiary 
anxwer is a cauiuiUN ">e?fc'\ The newer nuKJcK ii>c [ mjim» 
(read 4|464>. a 64A4k bit ukaM. The modification. a> 1 ^ee it at 
Ibis pwnl, is simple. The 'lsist miih!plc\**r is niiLiccd with 
m 'LSI w which IS pcrniancnliy enabled, Ihc two p*cudi> ad- 
drcuoi are then used to drive the select pins of one half of ihc 
'LSI.W. The four nuiinit pm\ an: then coniK\tcd to ftnir bajikv 
o( 2Ati4:^4K bit dkaMs. The problem here i* the additional 
wiring of the Dkwix, AH this is. as I said, prclitnmary; I 
haven't tried it yeU and Tm ^11 in tJK pruccu ut UrawmtE up 
the M.- hematics. 

The other potftibility here i% fomfcing the two x 4 orams on the 
tnwil and laNing in a bank or4l2S6 V Alilioujzh ihc lavinil of 
iIk: s)^u:m boaid in quite ditlerent than iJut ot tJic old 64*i, all 
ihc signals needed arc dinM!\ ;KiessibIc \1> i'piniiw i\ that 
thiMMho w.i> logo. Bulajjain, I tuisen't tiu-d it >ct. And DRAM 
iscxpensivenght now (Igotmy nrM25fiKrnr$50). 

\uui rwxt iiueslion it a bit unclear. Does this KamEx work 
with ^t'oPahu* I Like it to mean, di> you gel \\w fast i>\t\ that 
allows the quKk NcroUia^ about a geoPamt docutncni? If 
Ihat's your question, the answer U no. As I menlioncd in ilic 
anicic, tlic siavh. letch, swap and vehly rouuiics are not ^up- 
poded. StiU vague.' ibcDMAnHitines inoeosarebasedon the 
principle thai it\ faster to u\e Ihe kll it> move data than it is 
k> use Ihe SU'L, Axhl \lK}'rc right, M> KaiuLi^. however, U-scs 
The stn- to nwive data, and nince it moses it acn»s% KinKs. that 
Tin>\e IS a little skiwcr llun a MH>ve within one bank* So, fur 
thai reason, I cho^ iKit to support those mtnincs. For that mh 

^nn and another: viHi can ^uily mtHliU mi inuLh i.l.us code hc- 
tuie >ou run out oJ space. 



lo inipli.niLni ilhr (il-€)s mini \Mthout i:foFnixrttnMWr: Use 
PAL or Mime other asseinWer (I used to uic Btuhh). Type in 
code remembering to expand all ma^n^N. shi^nen the riHitiiie 
names, and make all iHhet ^.huik^c^^ appropriate to your a^^scm- 
bier, Tlien awmbic and split the the header maouaUy firom the 
projr/am. Take a look at the nios pr*ii:iaiii tn«ii the previous 
Trwfsutior. {This is a rrfrrrmr to rhr "maketofifns'' pntgram 
and PAL-format mhitxt ctide rhai hui fvatumi m "Pntftram- 
mmfi: m Gtos" by fiwun O. Kinwllu in T 9:L - MO/ That's 
how they did it, 

(.ojuLming the 'alleged' advantages of fsroPntjirammer Hav- 
inj: Used it. lhuU\ and PA!., \ wouldni go back, li\ just too 

good. And. of course, lor progfamming under OECkS, jasi too 
necessary! 

I know it\ impossit^c to get text to line up properiy in 
\:i'oPimiL If yiHi want to gel rid of pni[x>rtional spai^jng, try 
using the OmiiiHidore font. Il s an ugly Um. but it will do just 
that. If your problem is getting texi to lirur up, use iIk* edit tix>l 
and just move it mto place. Once you develop the knack, it's 
quite easy to do. 

About expanding the 1 2K: my only iNnight there used to he thiv 
pijjgvKkl the PRAMS ujih 41M\, bend up pin 15 and ctmnett 
it to the MML'^ •t.vi^ and '•t.vjij outpui. IliatV an easy 256K. 
with fWK unused in any w^ by the OS. Oiher than that, 1 iWit 
have atcess u> sclicmaiks kir ihal machuie and jxu unlainiliar 
with its arvhiteclurr. Will my ahme sug:gestion even W'orit? Isn't 
that part of what vtw'rc gcltmg at in vinir comnems? Vou'n: 
better qualified hen: than me. Aith<High I would love to pet my 
haiKhon the st.fKmaik\ lorthai ma(.hioe, Ck»t an order number? 

SofTwihing I want lo get at here aNmt your mtKlincaiif>n. It 
seems that it would work, >cs. And. >cs. the RAM would be re- 
freshed via 'RAS. But don't overiiwk the CM power supplv. 
One reaM>n I went for replacing the Uk \\|s aliogcihcr was that 
puwci supply. Too much suppon ciauiiry and two much 
t«tA\f ei|ua!s inw dead p»>wi:r Mipply. and that dead |Mn\er sup- 
ply will projiabl) have taken the Ufcv,M with it, SoiiKlhmg to 
consider! My hoard does not n^quire a be^-fier p^iwer supply 
lexcirpt in ihos^- marginal case's i, \t\ M ran iiH su muiuhs be- 
ton: I gi>t an RH', with no proWems. And then I w^nt to 5I2K. 
which dellnjicl) requires the hea^iei jvwci supply. 

AlthcHigb iri certainly n<M t^vious. I had two ovoridfaig am* 
ccms when 1 went at this expansion (hojccI. Keep tlie parts 
count di>wnaiHlkeep It imn^pan^nt, Tsmp the MM' pi>n liTenUy 
TcqnirLd rhc nusier disiihk- swjich. Ami the iHhcr swjkties? I 
agice, itwitchck an; a step in the wrong direvtkm. But 1 wanted 
to show that ii could be doix- stinpl>. Ihe other optH*n. even 
when that board w^ bcin^ developed, wa^ on H-bit latch 
mapped into phantom m space, hut the addiiiiHial cimiiin was 
too mu^h a cimiphcaEini; fjtUtf. I ilH>u^hi dial many nioa" pco- 
pfc would tr\ to build a six-chip Nwd than a twelve. Yes, my 
first SI2K had 12 chips and wa\ .i p.iichi>n ihc or ij;! rial board. 

Paul BiKjHki n 
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How Random is RND? 



An analysis of the C64 and CI 28 RND routines 



by U.J. Morri«^ 

The hcginrKr in B\&jc is often nurpn^ 10 Hnd the rnd func- 
tion. What i\ the u%c of a funclion that \upphcs .in .illc^cJl) 
coniplcici> unpredtcuibJc number? Ihc mure cxpchciKcd pnv 
pmmmer sees the urllity of such ;i funcrion in gamcx; or, more 
M'Mouslv, in Miiujl^itionv. Bui M>nK new questions occur: bow 
docs Ihc u>mputer ^encnile thcM* random numbers, end are 
ihc\ [nit> raiklitiii, or do rhe> cxhihiE sonic hidden bia»? 
You're about 10 implement a coMn-uiiing mvemor>' conimV 
svxiem. based <m >our vlmuLuiim of tvpical ilom.Li>d le\eK: 
will It cut a>MN or lose sAcs* Or you're :«pccii>iag maxmium 
drainafc capacitv- for a pmpowd municipal 'itonnscwer %y%' 
lem. jher Mmuljfmj: 2110 vearx of niinljlj c\trL"mc^ on >our 
eomputer, 1 hi\ could gei cxpcnii^ive? 

Pan ol Ihc problem u UM • landom -number generator iv, b> 
its %er> nantfe, difRcuIr 10 tnt. If you come up with a ^a-ar 
new squarc-nx*! niuliikr, you need tr> only a lew \flluc!. lo 
know if ii worix properly. But 1 random number genernfor can 
he shown to be 'ginxl' tmly b> exammin^ man> obscure pfO|^ 
cmcs ot long ;<i|uence\ of numbers pfoduced by the general' 
lor. Mo\t of us lock both the skill ami hnu.' to n|!oroLisl\ ic\i a 
KND luikiion. prctcmn^ to tru\t in the doigjicr^ ol tbc basic 
Imerpnrter, Unfonunaiely. the RVO function, tt% implemented 
on the CM and ('I2H, has a nunilvr of Ncnous shonc^>niin^^ 
thai should be nxo^ni/ed if Hsii is to be u%cd effectively. 

hi theory, a computer b a cuinplclely dctennincd hyMem: giv- 
en the initial Male, and in The absence of MK'h variables as kcv- 
b(urd input, the subsequcni states ol the computer are com- 
pletely defined. Such a system cannot generaie true random 

nuinhcrs: instead, KM) f>nxiuccs pv^iHlo-r.Muioni numbers. 
They paks <or should p;issj all the ICM^ ol random numhen, 
%\Kh as ivenfe value, standard deviation, and mns up and 
down, but Iticy jjc generated by MXikc ^pccilic iiuuhemaiicail 
technique The proof that thew are no! true nmdoni numbers 
lies in the loci ihai the same sfi,|iiciKcs can \\r created over and 
over again. In tacL there an: three st.'|>arjie mathematical tech- 
niques used m peneniie ps^-udo random nmnlvrs on the CW 
and Cl2t^. soiikctmics in coiijuiKlion. 

The first is jui:^lin^: the digits thai make up the number arc re- 
arranged in Mvne defitted pattern. In the CM and CI 2ft, this 
ju^^*linj; is ih>n^- on the Kisis i>l itidivrdual bytes of a four bvic 
number, lite second ?tysiem is multiplication and addititm: 



Mime staning number k muhipMed by one constant, aod anoth- 
er consiani is added. The resulting nindom number is perhaps 
altered in Mime other way, and becomes the starling point for a 
repeal of the Mine priKcss. The third sssiem involves passing 
the buck; the computer me^ 10 find some external v>ua-e ol 
random numbers that it can use to ^enemtc Its inicmal random 
numbers. 

The R\D function on ihe C1?H is hkcalcd in ko\t. starting at 
S8434, in Bank 15. and is the same in both Vcrsums u and I of 
the ROMs. The routine makes cMcnsive use ot Pktaimg Point 
Accumulator itl. {H\\ ir|>. whca* QASlc storeys uitcniicUialc 
results, located from $63 to $68. Another imponani sTi>rage 
area is called k\i>x. locaieil from Si:iB to SI^IK This is ihc 
mystehcHis random number «eed, from which new random 
numbers grow. Listing I iii a commenlcd drsasscmblv of (he 
C128 rouLine, ^ubtuutincb used by KMi are not included, but 
itwtr piirjvwes are indkaled. 

TV C64 RND routine is located at $E097, fpa •! \% al $61 to 
S66, and hndx t* ai VK»Mi \lihoui?h some ot the deiails and 
Mibroutinc calls are dillcrcnt. the general flow of the C64 RND 
rt»utinc is the same as the C12H version. Listing 2 is a i.x>m- 
nK-nted disassembly of pan of the Cb4 RND function. Mom oi 
the following dt^ussion of the CI 2R muliT>e applies equally 10 
b<Mh conipuiers: where dillcrcnces are si^i^iivauL llu:> are 
noted. 



The C128 ruuiiiic Ham m $S434, by deiermming the sign of 
the argument of R\D. s|<ired in fpa »(, The rouiine then lakes 
ihnre djllcrcnl mules, dcpctidiiig on whether that arguntent i^; 
a) i>egative: b) rero: or c> posirive. 

(The C128 and CMvenkms of this pan of rnd are identical.) 



If Aeargumem of rnD It negative, ihc C12K riHiimc branclvs 
10 $846A. Hcie, the first and founh bytes of fpa #1 are inter* 
changed, then the second and third. At ihis point, FPA a I con- 
tained ilie ihcgalivc at^uiikcni ol RND. The sign byte is set lo 
rem, makinp the value positive, and the exponent hyic i% 
Iranstetted [o tlK" roundJiig b>ic- The exponeni byte is then set 
to S80, meaning a number between one-half and one, and the 
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ntimher is "nomuii/cd". Ihc pnxcvs of witching hvicv mjj 
lijvc IcJ lo a number m which the mo»i Mgnificani hii <or bits) 
i>l the mo^t ^tpnifJcant hyte i^ mM a cmc. During nofmali/jiion. 
ihc uhnk' [our b>ic tjumtvr in H-a »J j* Jiiiicd kit, und the 
exponent dccrcj^cd by one for each ^Wft, umtl that mo*i sig- 
nifiLimi bil M 4ine. The nc\K hiK needed Jt rhc least Mginrlvam 
cikJ oI the number lit any) air oNaincd Imm ihe nxmdin^ 
byte. Tills new mimScr in FPa #) i% left (here av ihe value 
rciurncd f>> th^- RM> ruikUmi. but a copy upacked^toml in a 
slightly diflfereni way) in RMix. Maninp aiaddrett$l2tB, for 
fcavins that mil <J h(ipc) bc^unio Jcar s.H)n- 

Thu^. we see Itiat RNDofa negative nuTiibcr creates a randiw 
number b> carrying out a ^pccilic nuinipuJation on that nega- 
tive number. So, Rnd(0) will always yield the s.imo ndinlvr 
Mii\ KM«' 1 122331 s^ill al^^aysyicJd Miiik: iHbw ^pcciJic num- 
ber. RND(-> on the CM follows exactly Ihe ^me pnvedure: a 
given nepative arj!unK-ni give^ ibe same random number un 
butli machinc-t. 

A* Ihe disasst:n»hi> ^how^, ihc koM MgniJicanl byte oi the 
argumem becomes the mort slgnificani bvte ol ihe lesuliimg 
random number II tlie argument Is a number wuh onl> a few 
digits (when expressed m binary floating poim formK then the 
leaM si^MiifKiml hytc h»r bsiesj v^iU be /en». Such ar^urncnis 
incluile im.^.j . ajid fraciioti* like OJ32*H23 il7/l2H) and 
0.890625 157/M), When ihe^ zero bylcs arc f^wiubed to 
becimic the most sii;nintani b>ies ol iIk random number, a lot 
of normaJi/alion is necessary. Thi^ in mm means that ibe 
cvp<>iK-m IS decreased a lot. cnraiing a very sniaJI random 
number. KNDt-37), for example, is 3.45WW076E-8. and 
RNW-6.625> i^ 4,9479241 )3K-N, On iho othef hand, ihc binary 
rrprest-niatioii of 37/l3L lor example. u«i all four byiev and 
RNO(-37/l3l) h a more neasonaWe 0,985681329. (Can any 
random number be Icmied reasonable.') 

How tloes R\D(-37/l3l| compare to rmh-37/I3I/2i or 
R>D<-37/l3rw>? They are ihc same! The only diffcfence in 
the binary floating point form of ihc three arjrumcni^ ts ui the 
cxpinienr. an,t the cvponcnt gels slullcd to the r<*ufuling byte, 
lo be u^ed as the *oorce for new bits durinp nomiah/ation. 
Since these arguments use all four bytes, htile norniah/ing is 
fciiuired. aiid the rounding bylc is pn>babl> not needed. On the 
other hand. R\T)*-5). RVIX-IO), and R\ri(-20K alihous;h all 
vcr> ilosv. are dillercnt. Ihc difTcreni cxpuncnu of the aiyu- 
mcnts. stored in the roimdmg byte, hectmie signifivant when 
the rmdi>ni rmniKTs. wiihonK a lew b*t> m;L arc nomiah/ed. 
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I have often seen anicica lAidl fccomniend kmh-tI) as a 
good stmrce of really random number*. Since the jiffy clock 
kcepa lime in imegnil numbers of jifTie*. il i% clear thai hwm - 
m will always yield very small random numhcr*. I*cUu|)s a 
variation lile ftND(-'n*SQR(2J) wtnild give the desired result. 



i Hie CI28 and CM version?* ol this pmx oi RND are Mgnifi- 
canlly difTerent.) 

Rctcmng to ihc dteaucmbly ot the rnd routine again, if the 
argument of rnd is zero, the CI 28 riKJtine falls through to 
S843B. Here, the routine «lo:li Bank 15. then proceeds to 
load FPA #1 with the content* of $DC04 to $DC07. and jumps 
to SS4" \ Ihis IS Ihe same pan ol die routine tlial «ts iIk- ^i^n 
po&itivc, Ihe exponent byte to $80, normali/cs the value. 
ci»pies itto5l21B.andilienexils. 

The locations that pftxlu^e the randtmi number, SDCtM to 
$DC1»7. an' hnir ngiBaers ui Complex Inicfliicc Adapter (HA) 
• I . These four bytes Mote the high and low byies of two iniemal 
16'bit iimer\. They are not pan m ihe I mjc (>1 Da> Cloci^ 4s 
iome relcrentci have Maied ibut see the C64 version discussion 
below). The limcrs are iv»ntiall> used lo count pulses ot ihe s\s 
tern LKvk In llicory. cath byte could have aii> value from lo 
25.^. giv mg totally random numhi^rM however, only one of these 
iwo linwrs IS mnmni:: llie other limcr. ai $DClM-<)5, is u&ed in 
the CI28 for tape and fast disk oficrations. and is hf\ sfoppL-d bv 
these RHjIines, usually reading 2 or I. tntci and tun this slion 
pnigrum lo display the four timer byte*. 



too b*Ak 19 : M 
110 Cor lt-4 to 7 

120 nmxt print 
130 90 to 110 



SMtO 

print 



P#*k(u « kl. 



Aa yon cao fee. onl) two of the four byie* arc changing. Tlih 
hmitH Ihe range of posstWc values that will be iransteiKLl 1,. 
i^HA »l. and Ihus limits the fajklujii number* produced by 
RNiHO). Since only the finst and third bytes of the random 
number are changing, while the second byic is a conitant, and 
Ihc lounh IS zero, the rewli i* a ^i of nmdom numbers eluv 
terrd closelv (btit not very, very closely* ,iK>ui :5(> evenly 
spa^^cd VdJucv. 

To demonstrate \\k effccl of thi\ stopped timer, run ihi* >bon 
program: 

200 print rnd(0; ■ 2S< . go to 200 

Nt>le thai all the numbers prmted an: very cktoc lo whole num- 
ber*. In fact, if the stopped timer h trading I, the fraciiiKial 
pan of the numK-r will be between O.OOiWdlS and 
U.UU78I25; that is, between 1/256 and 2/256. 



This limiiaiion scrKHisly docnKCk ihe tocfulne** ol R\U{i}y 
For example, you may wish lo gcncmie a rmdom inleger 
between land Hit>Oinclu-sivc;asiaiemeiu]dLc: 



l»t (rnd fO) ■ 1000 * II 



SiiKC KMH-> always give* the tame value for a given negative ■ 

arjrumem. it would not appear to be a very u^,-\u\ random- 

numkr j-e.ieraior. lixlced. about the unl> purpo^^ of kM^.> ,. would appear to do cxactlv this. In f;ict. onlv 2S6 of the 1000 

10 store a new, definite valtie in the Rvnx ..na. iniegerx would evei be generated! 



If 



«l 



Afm^999:Vokm^% 






"TWs i% a veiy pood irawn lo avoid rnikO). Hottcvcr. rhert 
may he circufiixtaiKCN wtHrrc it mu\t he u\cd: for c^jmplc. lo 
iiH.-a*ikM: ^pccd iscc ihc liming rrMilu hclovh i. To make rmxO) 
iml> r,iru1nin. (In- \Ti)p[vd iimcr muM be ^lancJ jikI ko|M run- 

mn^;, Thi<» shuil piD^aiiu lot Lhc C12h, i^ill sum the Uii>cr 
.ind sd It couminc down repeiuedly fnnTi 65535. 



300 teAk 13 

310 ta-StilSO po1t« uM.29S:pok» m«S, 255 

320 poJi« M*14, 1: md 

Rerun the pir^iiMi!* RND40> examples, jhcr suninj; the 
Hmer. and yoa will sec that RNtyO) i« now wcllhehaved. 
I niortiinak'ly. any serial p<>n opcraimn, \uth il^ *..illing up a 
DOtGCIORY. will Mop ihe timer until the progrsm ahovc i^ run 

afain. 



The CM vcrvion of RVtMO) ia quite \im\lm <iec Lisling »2>, 
H hut UM.-% sunu- Jirtt-a-nt rcgiviern on ri\ #1 lo generate Ihc ran- 
dom numher: the two rcgiMcni of Timer »A. for Byte^ •! and 
#3, ami the l/l(» iwcond and %cti>nil^ n'^i%ier\ of the Time ol 
Day Clock. Jut Byles #2 jfkI #4. To lAjtch ihcue fegiMer> on 
the CW, run ihis pn^j^nim: 



ISO M m S6320 

140 print p*«k (■«-><) . p*«k(JA+S). 

pMfc(»a>f) 

170 90 to ISO 



k(»«i). 



Nolc thai Ihe last two repUfriA iire fitcd al /en»: lhii%, RMXOl 
on ihc CM i\ even more limited thou ilk: C12H \crMoiL Run 
Ihc pn>fcram ftnind in Line 200 above, to demonMmte the 
cffeetof thi^ pn.>blemon R^[>^^^, 

The Time of Day CI(Kk is njnning: however, until n write to 
the l/IO M.vuiKl tcgi^ttcr talhcs place, the registers arc latched. 
Run ihi-i pmgnm: 

lao poktt 54320, 



at 



lu allow thevefMCfBto loiluw Uic imKi n:-run the 
Line 1 50 and see the chanfe. 



Unfontmately, diis doe« not impmvc RMifO) on the CM very 
muk,h. The t/|(l second a'gisier only runs up to 9 idecimah. 
and the nocundft ivgixter only tuns up to 89 tdccimalj. SSV. So 
even if the Time of Day CWk rc^tster^aie changing, the ran- 
dom numbers getKniied are still clustered about 2S6 vi 



AmHhcT problem wiih kMx(h is ilui. if it is ust-xl rv[X'jted]y. in 
wutxrsston. in a BASIC ptik^rum. the thnen will c~han^ in a pre- 
dki.khk wa\ in Ihe kfnnMiint inicnal between succcssi\i: c;ill\ t*» 
kNU>icliJiii^/iairAot raiKluiiiiumbctMhalaa- highly comrlaled. 

Forevjiiiple. usin^; kMJ(0) twice 10 MmuUc rolling a pair of 
dice will produce a very unusual, non-random dUtnbution of 
pair* of wilue^, M»nic pairs of values wiH never appear! Try 
thift vhon pro^iu^;^. 



400 dlH m(C, 6) 

410 K ■ end {.} : y • rod (J 

420 X ■ 4*x«t : y * (ay^l 

430 a(x, y> ■ at>. y) » 1 

440 9«t qO: if q9>** Umo goto 410 

490 prlnt^prlnt 

440 for k - 1 to 4 

470 for I • t to 4 

410 print m{k, 1} , 

410 a*Kt I : print : ooxt k 

300 90 to 410 

Prcs'i any key occasionally to see an updjile ^f h<»w often each 

possible pair ol \alucs shows up. NiXe llw extreme noih 
mndtnn disinhulion ol ihe pairs of valueii. Switching lo FAST 
mode iKtcniuatcs iIh" pn>Nem. Intcmipis ihji i>L^ur beiween 
the two calls 10 kmxUj allow the timers to run for dillercni 
lenj:ths of lime, and incnrasc (Uightly) tli r.iTuliinine^s of ihe 
disintniiion ol pairs ul \alues. The rcitulU of thi> pru^nim on 
the CM are Mill distoned. hut less severely. 



Hor both Ihene tetaona, KND4O) should he u<cd only to create 
new \alijeN f<»r K\DX,aa wns ihi- mascot for R\D(-> 

RNDf+) 

<Thc CI2K and CM versions of thi?^ porl of RND are identical,) 

Relening once more to the disasNcmbly of H\i\ if the avgu- 
meni is pos]ii\e. ihe nxitine branihes lo $J*455. Mctv. the 
number stored in$121B - Sllif (KNUX) i^ nxovcreU auulPA 
#1, and mitlliplicd by the con^itant stoned (in floalin^point 
fomu in ROM at SK4MO SH4^ llic coHNlaiil m SK495 - ^K4W 

is then added. The routine then falK ihKHigh 10 the code that 
juggle^ the bvies, seis the sign and e\[mnenl, iRtmiah/e?* and 
fuially stores Ihc new vaiuc back in S12IB< 

Note that tin: value tound m i-PAffl at the bcpimmg of the rou* 
tine, the positive aifument of the Rvn function, is never U'sed. 
Instead, ii is cner-wnticn h\ ihe last r^indtwn numlwr^ stored in 
KNUX. It i^ thJN old random number that is used lo create the 
next random number which m uim beconn^ ihe ^ced for the 
next raikkmi number. 

Any pi»sihve ar^unH'iil. unisiuni nr vjnahlc. Jiw R\0 wiHlId 
have produkcu exactly the same ne^ landom number from a 
given seed. 



Rom this ietcripllon. it is ckar thai, given a panicuTar salue 
stored m K\p\. repealed um; ol RNU with any pusiUve argu- 
ment will give the tame sequence of random numbers every 
lime. The cold-Man muiine imtiah/cs km)\ to /cm. m> ihai 
iimply using km> with a po^kitive argunKni would always 
yield the same sequence after reselling- The <inly way 10 
change to a new sequence of raixloiu numbers i> to change tu a 
new value in rndx: use RVtX-). if you want to awiich to s^mw 
specifiL scijucrKC, or kmx(I), if you wish to jump lo an unde- 
termined new sequence. 



Tfonaoclot 
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One impimant ijucMinn ahout RND(4) h: how U>fig hcf<»rr ihc 
tamkim rmmbiTN j;ciicruicd ihis way hc^in lo rcp^-ai. ki,-nK-it»- 
bcr. 4U kxig A> >ou u^ knih+). you arc rullowing a fixed paih. 
jumpinp in a iK-flnilc n>ulc from ooo numk-r |4> anoilur S*xin- 
cr or lalcr. you muM lanil on a nujnbcr you ha^c hrcn lo 
before. After all. there are only v> many diffcrrnr numhcr* on 
\ihich ui hmd Omlc rhis hj[>|vnN, >ou then repeal yuur previ- 
ous KH^**'****''-" wf random numhcf\. mer and o\'eT, The length of 
Ihis U^jp i\ JcperulcrU on ihc consunis uu-d lo ^encrjic llio 
ne« nuidum number trum Uic old one. J y^ns euriom tts to htiu 
w-ell Ihc C64 and CI2R ttcxigncf* had chovcn ihc%c consuniv 
The machine Lin^-uage program iLtsUng 3> uaji wnuen lo 
deicmiinc ihc length of ihe^tc loopL 

11k problem ol finding ibc loop length is complicaied by ihc 
posajbiiily of a \ilu:ition like thi\: r:ini1om seed A puitiKCN B. 
uhkh pnnluvcs C, whuh proJutc,'* D. which pn>duces E. 
which produce* F, which produce* C. and The Iih»p i\ complet- 
ed \Mih»Hii ever nriuming lo A. The *ci|uencc tonsiM^ ot a 
liHip. C D. E. R aft well as a "toil". A, B. There i^ not cnouph 
UMnn lo keep every random nunibcr of ihc %eiiuciKc in 
menKir>. ow is ihcrc umc lu check ihc euncni random number 
apain^ all previous random mimhcrN lo find a match when i!w 
k>op closer. 

The M>luiioTi is lo run iwn sciiuenccs. TlHr> hoih sun wiih the 
sajiic .seed- One sequence calculiie* RND(+) once; then Ihe 
ofher vNjuencc calculatei^ k\lM*) twice: ihcn ihc procc^^ iv 
nr[vatcd. Bach \c^ucTkc \o,uls it^ own old Mxd inio RNDX 
before taking its itikgle or douMe step, and \avcs its new cur- 
rem seed altcrwards R\cniUiJIy tficdoublc^lcj^in^ sequence 
will complete the loop and caich up with the single stepping 
sequence from h^'liind. The nunilx-i of sicps iKcded is ilie 
len^lii u1 the loop. 

The siioMioa b a bii more complicated if the MHjuciKe start* 
on the toll aiiachcd lo a loop, as drvrihed above. If the tail is 
kmg. Lomparcd lo the kK»p, ihcn the projiram in l.iNhng } wdl 
record a length thai is an>ruximately equaf lo ihc length of the 
tail- The reponed k-wzth will be a multiple of iJic looj> length. 

When Ihis ML progrsn wa^ run with over 1000 difTcant sian- 
in); ramlfTiTi ^ct-ds, a rcmark.iblc paiicm wa-s discmenrd. lull) 
ayi ot the sequences kK>ped in the same length: 63,671 nm- 
(fcmi numhcr\! Ab<uii 2'' "\ [fic scijucrKc^ LiHiiaincd CKactl) 
Iwicc 0* many numbcis, ilieac were deicmiineU lo be loops of 
Ihc same length, 6:^.671, entered ihniuph a tail .ii Kmvi .is long- 
No ^Hrqucnoc* longer ihan this were louad- 

The remaining; 15%of ihe sequences were ionsidcrjbl> shod- 
er. 5'^ ol llie seMUcncc<^ traced had less than 10,000 random 
numher^ The Nhorlest -.cqucncc obi*er\ed had only 59<> nuni 
hers in it! 

The nIuiti si-qncnces vhowed ini>ihcr ^uanje propeny. llw> 
■Jmmi all turned oul lo be loops w ith laiK and the loops were 
of *mt\ J few different lenglh-v Fw example, aboui 9'i of it»e 
M.\jucnccs iiudjcd turned out to end in Un^ps ot length 724. 



Sonu- i>t rhcsc soqijonccs had \er> Kmp tails, twenty or thirty 
ilH>usand numbers long, bui ihe loop at the end was quite 
shon- Another 2^ of the sequcnLC^ studied eniled in loop% of 
lcn>:ih 703^, v^hile a Jew other loop laigihs, like 4232, 2M4. 
and 566()»howedupal theend of a few %ci]uences The reason 
that Ihesc l(x*p lenv'ihs. and iml> ihese kx>p Icn^ih^. were 
observed u a mystei> u> mc. 

Despite the short loops, ConimoUore >cenu to like this particu- 
lar vcnton of RNn<+K The two coftvianis used to geiK-rau- itic 
next random number are 1 1X79546 tmulliphcand) and 
3-W767774£^ (addend). Thc*c are exactly ihe same 
conManls as R\|> uses m the CM, atul ihus RSix*»onihc CM 
sullers Irom ibe same problem is K.\u+* on ihe C128. To 
illustrate this problem, f\m this \hort proi:ram *mi either a C 1 28 
Of ( (>4. wiih iIk' appropriate \aluc ol sa, the addrck* u^ Ihc 
ftlartof RNDx: 

ftOO a««40S : wmm for ciat« aa«119 fox c44 

«10 bMk 15 : faat : n« oa el2l only 

#20 fOE k>0 to 4 T%md « poka aatk, a: nmnt 

630 data 12a, lis, 15J, M, lfl7 

€40 y • rndll): print y 

•50 for k > 1 to 2M: a • cad|l) : noxt 

ceo 90 to €40 

Thi* program *ccds the five byic* of rm>\ with vahcs that 
place it on a hH>p ot length 2V5, If you now use RNLH+j repeat- 
edly, you will generate the same 295 random numher* over 
and over again. As you can aee from ihe tniipui 4>f ihis pro- 
gram, the Aame value of Y is generated ami pnntcd each time 
around \Uc Uxip. All ihc mher 2*>4 randivn numbers are a-pcai- 
cd as we 



A curi*>us proj:ramming trick turned up wlwn I chccicd llkC 
values of ihci-c RND cooMant% in eailicr PFTjCBM «yitcms The 
dcsi^-ncfN managed lo More two fUebytc constants in only 
eight bjlo- They accomplished this apparent mirack by over- 
lapping the consfanT^ Tlius the nfili b>ie ol ihe first c»>nviani 
IS aKoihe lirM b>ieof ik second Lonsiaiu. liie lird byte of ihc 
rouiinc is also the fifth byte of the second constant, When this 
rouiirK was transferred to the nuire spacious CM and CI2H, 

the u)ii>ianuwc*vi,iv^n live byte* each- Bui the two new fifth 
byte* were set to /crtv Thus iIk- constants were thai»j;cd in \al- 
ue slighil), and the sequencer o( rajklom numbers generated 
by Rfax+) 00 The PCT^tbm and on the CM and C12R ate com- 
l^eicly diUercnL 

Althcwgh 63*671 randi)ni nuiii>x-rs %cvms like a loL it Bhoujd 
be con?*idcred m lighl of the over 35 billion pa^Mc random 
numbers. Clcarlv, for any particular starting random seed, iin!> 
a small fraujou ^ir .J I jxjssible random numbers ia available on 
that particular sequence. If the total number of random nun 
hers used exceeds hl,ul\. as it well might, the sclcclion ol 
number* will lu^ be niinkmi. There is also the distinct po^si 
bility of hitting a much shtwicr sequence, lor im|x>rlani appli- 
caiionN, ii would be a good idea lo um; RND*-) or KNUO) fte- 
quenily. to jump lo am^ther !<x>p. 
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\s the Ji^avMrmNy tiKliciitCN. then: ;in- Uit^e diffrrfncc^ tn the 
Uinrc pusMblc roMet Lhmui^li i\k kwy tuiu.ijon. rcsulimg in 
Urge difTcrmces in nccinkm lime. The^ execution timc^ 
VkCfc fncjsurvd for the CMS by enecuting ;i ^hun program 
with a luop that executed 20.000 times. The time taken lor the 
Mjiemcnt \ = rniiy\ wa* compwrd to the time for the stue* 
iiiciu % = y Thi^ eltntiiuicd the oscihcad tuiMr devoted to lind- 
inf and Mcwinp vvJaUcs. Naturally, y wa-* ntlowcd to he ncpa- 
U\c. /eru. jiid (H»%j(i\(.- Si,\L[al M^iufiLdiu ^c^ull^ \^crc 
obttincd- 

Fint. JtMHO) httd the ^tioftea execvikMi lime. Rnih-) ttxjk 

A. Ay timcv a\ lonp locKecuie, and RMW*) took 4,69 limes a^ 
long. toHipjied to KMXO>. Secundl>. the time to [\u^< Aixtl 
evaluate a numerical conManl argument was signincanlly 
lon^icr than the time neeJed lo liiul aiu! iranslcr a variable 
argumenr For crumple, the loop look about Wi longer to 
complete u^ing \ s rndl-1), compared to i ^ rn(l(>>, where 
y had earlier been detiiK-d jts -K Ihc abs^-ilutv Npccd champ 
w a^ Rsrx.t: the Bahic Imerpreier ncofnizrit a solitarv deci- 
mal pomt AS a zero Li\k-r than it rccojzm/es the digit ^ro, 
and faster than il can lock up a variable equal lo zeri, even if 
I hat V jrijble is at the be^innin^ of the \ariable tabic. 

CfNid ads Ice 

1) Avoid uting RN'D(0) unless abioluiely necev<^ar>. Stan and 
rc-stan Timer A in cia #1. if you insist on u^uig kmmO) iwi 
lheC12K> For nu\imum speed, uscKSlM.) 

2) Uv KMH-> lo coablish a ncvv M^|uetK:c of random num* 
her*. LV a\ the argument a negative iiumher that doe^ mn 
hase an exact rcprt stomal urn m lliuim^ pinnt binary nota- 
tion. Avoid number, like -78. -548. and -I2.H75 

3) Use RND(+) for moM purpuac^ Use a vifiaUe arj^umenu 
rather than a tonsiani argumeni, for a useful increase in 
spt.vd. Switch to a dinerenl sequence by using rmh ,» or 
RND<0) before the sequence begins to repeat, 

Lislinie 1 ; Cirnmwnud iUsasstmhly i)f titt CI28 raJf J wunnv Li&lint 2: dmrnwiavd dna\\ti>M) t^ the CW rndi > fuuiine 
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T\irning Off Write/Verify 



Modifying 1571 vectors 



hy Drnnls j. JanU 

Bcforr t ^rr inlo Iho ;kiiial o|VT;tlin^ s)Aicm I \«<Hi1il like 1o 
gi\c MHik; tuckground on ihc ISTr^^ipcnKm^ ^ystcni- 



\\ht'n (\>miiuKli>rc released ihc 2<>M di'^i Jnvc, vihivh \fc;i> a 
slngk drive tinil. il included DKk f>peniiing Sy^cm 2.6. DOS 
2.6 ihiiN txxjmc ibc M^irularJ lor mm^'Io di^k dnve unit*. ThK 
drive i^ uhot ihc V1C''I54<> ^^o^^ bused mi. TIkc WX-h bw^ was 
reduced to a \enu1 hu\, and ihc dtvk rorm-itinp mcthtxf was 

dunged (GAPl %^;is iiKKuscd by I un ihc 15-KJ). 

Thiv is Mh> the 4(M(> and 20.^1 disk dri^esaiefviiirfooinpjubk- 
with (he \i\x M^nes of diMt dnves but ore run HTir^ titmpufi' 
Me. Ftw more infomuiiion im lhi\ read/^riie pri>blem consult 
Ihc book hiMdt Cimwuniurc Ui^s b) Kikhard InuiicrN and Ger- 
ald G. NeufeM <in p^ 201 

When Commodore feleased the Plus/4 computer they Included 
a serial bus lor the existing ^onal bu\ dcvives. bin ihcv also 
included a new type uf hu\ called ihc iiii> bus. This bus \^as a 
cnis\ hc1\^cen Ihc nerill bo« and an ri } i bus \^iih S dai.i Mnc^ 
and a {c^t* handshAc lines. \\'hcn Conuikidurc released the 
1551 di»k drive faKo known a^ the 4X8 disk drive) Ihcy 
(David Siratuv,!) made several changes to the operating sys- 
icm. \bhH:h tiKlutlcd a Taster i«cit to binary converiion, a tasi 
format n*ulinc, and confr<,lionv for some old hugs in the hlixk- 
read and block -untc nniliric^. 



Oddly enough, ihis IM38 ww released as DOS 2.6. which is the 
same DOS version thai is Mill in the I54x disk drives, even 
Ihojgh iheir nicnion maps arc no\\horc near ihc ^anic. (\»m- 
inodorc's logic in numbering their uos versions is still not 
very clear to me? 

Commodore Kised the new 1571 disk drive on the I54x\ 
mcmtw) map \\hai David did v^iis lo a^m^ne a lot ol the cihJc 
he insiallcd in the 1551 disk dnve and splice il into ihe 1571 
1s4Jih .is the new gcr rtiutinc-^ .md (he lasicf ]L>iiM.iring ctxic, 

dc.) 

I only wJA Comnu>dofc had released the I57| uith a scnal 
bus and an lEEF or 1551 type of bus which would have 
incnrascd ihe *>M.'rjll ^[xoJ ol the dnve - il the l)i is \^as 
rec<Hled correctly. To wrap up all of the above, the onl> drives 



thai arc bolh Rati An^X write eonipaiihie arc the 4fW0 and 2031 
di*k driven, and the I5xx series ot dnvcs arc a-ad and v^ntc 
contp^ittble, Of course, you can*t put a 1571 disk in a ISnxond 
read aide I since you don't have the read/v^nic Iw^d to do ii 
with. YtMi can read the same disks with (he ISxx, 2030. and 
4(M0. buidonol v^riEc hack [o them or you ma> rcgrcl it 

One of the chances m-ulc in ihe 1571 Ik>\ waa die method h> 
which it liajidics the IRQs tintenupt KcQucslsj. lastcad ui 
always jumping to a constant memory location (addir<;s». it 
jumps ihfoii^h a vector iIk^ same wa> that your ci>mpuicr s Ker- 
nal jumps ihmugh ihe KitKtXT vector to output a characier lo 
ihc s^rcenyprinicr etc. SiiKc this is the first disk drive to have 
thi^ ability, such prugrotm a^ itus vhcrc not possible beJun: with- 
out a major effort on the part of the procramnKr, With this nc^ 
vccionng qmem in your disk drive wc have man) oiKiom to 
pursue ' such as the one covered in this article. 

The dri«c\ vrrifkaliun nailine 



Wliencver ooe Of ihc cum:ni diik driven Utuia llic 2U30 
through (orhecunoM I571>ttiites ;i sector to disk, il will then 
proceed to read ihal sector hack in off the disk (o vcr»l> it 
against what it has in RAM to ensure thai the bvtes were writ- 
kii correctly. 

Oenerally you will never sec an ent>r occur unless sou have a 
bod diskciic 4.ir a hardware luilurc m the disk drive or scnol 
bus. Normally a hod disk is detecied during the format pn>- 
eess. but thev do fail from tiiiHr ut hhk jii^t b) sining in jinir 
disk box. 



In either caate, you wonl aec tlic piolilcin very often- What this 
prt>gram docs wfwn installed in the '571 is to 'wedfe* itself 
into the iku vci^tor lo allow m) pn>grajn to check to sec if the 
ixis is about to dt> a vkkifY operation: if il is. I replace it with 
a SRF.K opcfalum. If yni don't umlcrsLand ajiv of this, don'l 
worry about it o^ it ui ntil nrquired to kium iu^^^ the pmgram 
works to use iL 

This program could he considenrd risky to some degree and it 
protiablv t\ nskv, hut I've been using this prntifam ilaily for 
three nuHiths with no problems ciKountered to date. Di> I 
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"\irih.ba§" - Tunw nffnnie vrn/y on the 1571 



This program runs on any 

CommoJore computer from the 

\IC'20totheCi28,., 



iKtal 



^uumnlcc ihU prognm? NiH on your disk I don't. Why, you 
mi^iht jsk? WcM, lo put it simplv. ibcrc an.- Uh> many vanahlcx 
mvulvcd; rrutajuurdi^ dnvc tutvmg the Hu, tuUisk^ that arc 
u-icd as floor matv It woutit onI> rake <nii' xmuilvc lo wipe a 
ilivk. (hi an> ,kL*>uiii. MJiiply mn ihi^pmgnim anJ^ivc Uatf> 
by doing Mwne testing on tijunk disk. (You know the one, it's 
the one you don't care if your dog or cai eats, or if Junior u^c\ 
aiiafiubcc! WhaiTm trying io?hay is ihar Tveuicdthi'' pro- 
gram Un quilt- ;i \^hilc with no problems t»n seu-ra) ditlcrcnr 
U'r>Knis ol the 1571 Ui>i, Operating *j>>icin. but ihi?. thoicc is 
up to you to make, not me.) 

Thi* *hon program aJlow* you to mm off the wiilc verify opera- 
tion in vtHir LS7I drsk drive even wliik- ir\ in the 1541 rrHxkv 
CuncnUy diefc arc sc^icnil >inuLir vcrtumv of ihis program run- 
ning amund on public ilifimiin Kiltflin ho;irdv hut scvcraJ of 
rhcm eoniain bugx he^.dUH' itk>, hke tins one, ut mok where in 
SQIUU. whwh is the diUt drive's stack. Most of the ones I hive 
seen ID date use up ro<i rnuJi nx>m on the sMtk .inJ. i([>i)n ilic 
iuM DOS error. - erash! - the drive diev The fallowing pmv^^T.im 
has hcen tested. rcMcd -tgain» then leMal more..* 

To use this program alt yoti need is a 1571 dKl drive and this 
pm^ranv This program runs on uny CiHiiitHKlorv vmnputer 
liuin ibe vrr :!o to the CI2K, To start the program^ J"M load it 
up and r>pc run 'I'he program will make only t>ne request, and 
that ks, .simply; "Enter ihc device number of your 1571 disk 
drive:". This value can be in the range of 5 through Ml and 
would Ik ihe viine nuriihcr ihai you would enter Tof a BAsrc 
command us dioad" filename" .utXTl or load "nieiiaiM**^!^ 
where XX is the dt-sice number of the 1571 disk drive. If the 
progmm findft that you indeed have a 1571 di%k drive al that 
devite number it will privecd with ir% jNMgned task. If ttkra' 
IS not a 1571 online, ii will di»|riay an crrur nK-N^.ipe. When 
the program has turned ofT the write verify o|vijiion it will 
inrorm you by displaying 'Wnie verity opcfulion i?. nov^ 
lumedolir' 

During ttie cour^ ul thi» pnigrain I make ^vcral ebeclts to 
en%urc this is really a 1571 diU^ drive: Firtt I check ihe iRg 
vn^tor at ^hKFE U) ensure il ctxitams^ an $FE67; U)u will 
ensure that it ti a 154)i or IS73i type of drive. Ne\t I check 
SSlKOlof theteuS/locn^unrrlisa 1571 JinK dnvc. haaily 1 
cheek Si)2A9 vfchieh is ibc iRg vettor for the 1571 disk drive. 
When I check this vector I ensure that the MSB of rhe ;iddre» 
t:m\ums a value greyer than i8U to cnwin: that the \kQ in 
going somewhere into ROM. and not tn .mmher program such 
as mine. If all of the aforcincniioned arc true. I download ihc 
ML itiio Ihc drive and execute il. 
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Copyrif^ltt V I*^SVDJ.Janis 



Tliix program WM wnitcn to solve iifti> pmhk rm J was ha^in^ Second, il util toKC ihc IX)S 10 iwd in Oli& disk's lomial- 
with the 1571 dinX drive: ling ID%. 



I > Convening a sin^lc-iikkd di«kciic lo a tfoaNe-tidcd one 

II 2) Doing a cuLLtci on a 1571 di^W while it wu^ in 1541 
I mode, oMuing il lo revert to hcinfE a Mngle-Mdcd disk. 

iNOTE; This problem has been eorrtclcd in the newer 1571 

divk dnvev) 



I 



I 



The fir^i piublem can be a pain in Ihc keyboard. Whai wa^ 
required wa*^ that I ii*ie the ix)S vhell or other such propram 
and cop) the \\\c\ o\er to a new!} lomuicd 1571 divkcUc. I 
could not u\e any full di\k copien hecau\e they would copy 
track Itt und from the ^^m^le siJcJ Ji<ik to the double- 
vidcd di^L, turning it back into j Mngle-<hided disk (a^ lor as 
the 1571 wax concerned). Well, thai gol to be a lime- 
consuming opcrauon. So I set out to find an easier way. 
Using my 1571 Im^rnah hook from Abacus Software. I 
began lo scan through the form.it roulmes. As ii lumed oul. 
when David Siracusa wrote the format routine, he set il up 
as a two-pas\ operation. I^irsl. he formjis all of Mde 0, then 
return> to toniui mUc L 



Before ] go into an} turllurr details on how io use ih^. l^'iinal 
riHJtine I w-ould like to tell you how the 1571 check« lo see if 
il's got a diHjhtcsided disketle in the drive or not. When you 
pciionn most disk functions, the [>isk Operjhng System (ixj*^) 
reads track IH sector (I into the disk drive's rvm, then checks 
Ihc 'hud byte iiuu ihal sci^lor (the tir^t byte i*> byte 0) and 
checks to see if it has bit 7 set. If it is not set, it is a sin^ilc' 
sided disk. If bit 7 t\ set, ihc dri\e will read in track 53 sector 
10 read the rest of the disk's Block Availabilii> Map (BAM). 
Ttis Lnf<irniaiion is used to tind out if a sector on a specific 
ir;tc L un Mdc \ ol \\\c di»k is in u^ or if it %s tree. 

At you can see. before the [j<>s will allow you to read a 
track beyond track 35 using the normal DOS, it needs lo sec 
bit 7 set in ihc third byie of track IS senior (>. M> proj^ram 
will always sci thiii biL After thi» ha» been done I send oui 
an TO: w hich divs a couple of thinps: First, it forces the disk 
dnvc lo reload track IK sector U into its kam (the bam for 
side O) and set the internal single/double- sided disk flag. 



Whenever you fonrat a disk using a statement such as 
"nOiciimmiwIore I57l,dj" it will make the di*k\ niinnr com- 
modure 1571. and place the formatting iiy^ in each header pre- 
ceding each sccior. In this case the formatting ITH would be dj. 
These II> b\ tcs arc placed along w iih iIk* name <m track E H sec- 
tor 0. These can be changed by various M>tiware prpgrams 
Hi>.h .IS Hf KntRCHASGi. which is on ihe 1571 tesi/Jemn disk 

which wa^buiKllcU with your 157L U you change the name ol 
the disk or the disk to on track 11* scctorO. you arc just chanj 
ing the mionnaiion thai >ou would sec when >ou load/a'-Kl in 
Ihe dirccloiy. The actual formatting ID bytes cannot be 
changed without reformatting: the disk from scratch. 

Once the disk has hoen set up as a JnnhlC'sidecf disk, and has 

read in the disk tu byte^. we'ie xkM^ to go to work. Next, 1 m» 
Ihe read attempts lo one to prevent the disk from tcarchtnp too 
long <so it does mH waste )our limer. then 1 aiicmpt to read 
track 53 sector 0. TVack 5? sector coutd have been any track 
on ih^' ^.L.lllul side of the disk. If I'm able to read in Ihis track 
and secior, then 1 know that the disk was previously formatted 
as a double vidcd dixk. but has reverted lo a single siJed disk 
due to problem <w o stated abo\ c. All I have lo do i<i lo pcrtomi 
a enfteef command on the disk to reconsinia a valid (conect) 
BAM. If Tm unable lo read track 5,^. «eciiM' Il then I know thai 
sitic one was nesci lormatted. and I need lo format il. 

Note thai this program dues mi convert tlippics, Mippies are 
those disks that have T^een notched on the other edge so that 
tbe> can be flipped over j^n^ used on the other side, Jn ordcf to 
format side one only, all I have to do is to enter tfw formatting 
routine at SA445 in the I57l disk drive. Once this is done the 
disk drive will go on iis way formattmg side tvie tmiy of this 
disk. If no errors occur, performing i collect on the disk will 
cfcatc a liAM for Dk second side, Uikc this has ticcn complct- 
ed you wilt Tiave a douhfe-sided disk with t>o files on side one. 

liven though this program rmiy sound straightforwanL U Is 
tuttf You must allow nuikr 2 udrd lo complete its ia%k or it 
will cauM! >ou problcnu in the future. An example; you have a 
single-sided disk that you want to con\'en to a doiible*sidad 
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di^. You pet all the way up to tt>c p<»mi where the disk wjn 
juM jhout to be formultcd (Mde one onl>, of anir^e*. and you 
change your miiKl and pull the di»k out of the di^ drive, ir 
you do not rerun (his program und wk\i no *^*hen it ask\ vou 
it you uani to tunnel the di^i, you will find ihui you have a 
big problem on your hands... 

Since my program has already set the douWc-sided flag to thai 
I could read hide one ot ihc disk, the nexi tunc >ou try to do 
anything «iili ihut disk uuch as skiving or loading a program) 
the 1371 MTcx llic douhle-«ided fljg mti and ines to re;kl irjtk 
5.^. sector to read in the re^t of the bam 4ud - bung! - a read 
error becauM^ there is no track 5S. urtryr ?vcaii\e il % as nev - 
cr romuttcd! 

To use mukf2 suhJ jW sou need In di» {> \o \\pc il in or obtain 
tbc Traiuaaor diA lor ihu i^uc fJdiik #27/, nin il. and then 
answer (he quMions, They are very Mniiphiforwanl ijuc^lions 
sut'h as entering the devkx number of your 157L This pro- 
tram has been tested arnJ operated wifhour an>' problems on a 
\\y :n. CM, PIus/4, B-I2H (with our fast serial bus installed, 
ol ^ounc), and ihc C\2J&. 1 matic Mia- ttuii I only U3&ed SASIC 
3.0 cofumands to allow cvcr)'one that own* a 1571 a chance to 
use this pmgr jin. 

Mak€ 2 sided has been lc^teJ. tested, tested, then tested some 
mofr. This prognim has already been nelcafted via the CBUO 
user's group for itK- B'12H cofnpuier viiih no ^.odipljpnis thus 
far. 

As with any piece of suftwiia-. there is room for change and 
growth, but this is a functional program without any belK and 
iU^s. If MHJ wish to change this si>fiwarc. make sure >ou 
know exaciiy w hat you arc doing or you could erase the wTong 
^ide of the diskette or find sourself with a nev* ileni in >our 
I57IS outer camt bccauiie you told >uur diA drive's head to 
take a quiets trip to Man. and t^ck. 

When make 2 sided wa& sent in. il was over four pages long • 
mosiK because of single line staleincnb. and masMse amouiii 
of conuiKnu. Piobobiy the comments will be removed, and 
the propnim shonencd due to space limitation*. I hope that 
Jtatnui fur w ill plate the BASK." program on ihcir diAeue a& it 
was sent to them so you can obfain a copj to follow exactly 
bow thts progr.iin works. [Mr Jarvis' program has not been 
sjkufwned. In fact, a line w^ added lo get amuiid the appear- 
ance of an ELSL token, Axidc from that, noihnig has been 
rrmoud. -MO] 



A couple ol i^loMtii- LunimentsriKMiindc IK sector 0: If you 
UxA at Ihc last few b>ies starling at byte SDD you will see the 
njmber of sectors free on each track on side ihkv im not ecr- 
lain but. in my upmtun, David did this to allow us (program- 
mers) a way of seemg tf any tracks arc in use on iheoCher side 
of tlicdisk. 

UVn I v^rotc a full disk copier for the CBUC (B-128 users 
group) i used this meihtnl to see quickly if any «ec1or« were in 



use on side one of the disk. This would give them the option of 
uMng a IM\. 2031. or MMi disk driven as the source disk and 
the 1571 disk drive as the cop> disk. The oni> drawback I can 
lec land ha\c been atfecied b>j is that my normal medlod of 
reading in a ditk's BAM and directory no looger woris. 

If you open the directory up for reading tnoi load"$"^ etc) 
you w ill be able to read in ihe disk's h\m at tbc same time. On 
the 1571 It will not send yuu tlh: bam lor udc one; you tuve to 
go gel 11 yourself with i Ul commiind Oi^r lasU cotnmcnt 
aKmi Ihc fonnat ID b\te in ihe B\M: lliis h)te (bjle 2 slartmg 
withbytcO)i»aS4l on the 4<U(), 203 K and I 5kx drives. This 
byte has been confused over ttie year* as the lomuii type byte. 
In my opinum thi» tell^ you ihc number of secior% per /one 
and is laid out as follows: 
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AM of the nMvc tabic is of my owi CRUion ami ^ftntftn ThLc 
the iuKM\mi'LMl liK example. On ibc i54xand 1551 ihc> 
are all read/write compatiWe and are identical in about evcr\ 

w 

wa> and are currenil) h^miaiied evactly the same> On the 4040 
and 2031 drive*, there ts an extra gapI b>-te in the fonnat pro- 
cess \^bencompan:di*uhc l5K\dri\cN- Due to this extra bvte, 
Ihey arc iKH write cumpaiiblc Vkith the ISxji. 

The 1571 \s double sided dnvc with a different BAM ^bcme 
when compared to that of the 203L4fV4n:ind IMx, and 1551 
type drives. In oiln-r words, ihis buc d*vs n^t indicate the 
number of tracks ^m a disk, nor the fomiutttn^ meihod u^ed on 
the disk as >ou arc led to believe in the disk drive's nuinual. 

One interesting point: on all of the Commodoie disk drives, 
the DlHl.rn>K> rounne dctaults back to tlw 2(M0 disk drive 
whKh was VERSION I as the formal type. On the 4040 if you 
Chanfe ihc 2 \ on track 18 sector to 2 tollovsed by an SAO it 
will Uiow It a> 21. after the disk name!. This holds true for all 
on the Commodore disk drives, including the H050/H250 
dnves as wcllV (change the 8050. 8250 from 2C to 2. fol- 
lowed by an SAO), 

If anyone has any input on my opinion, as stated above, please 
«end it into TninsaiU>i\ \ wixild like lo hear from sikh pe<»ple 
as Fred Bowen. Jmi Bultcrticid, Ui De*l, Jc^sc Knight. Anth- 
ony Goceliak, David Simcusa or from anyone w;inting lo 
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nuke a comment! All of rhe ftfofrnu-niinnal pn>^ramnicrB 
hive been pTii^r;immin^ on \anoiu ConkiiUKtorc di>k Jnvo 
for many yeart. anJ hjvc for morr hiind^-on time than I do. 
LiVc wmany oihcis. I'm ^iilljuM ;i hcginncr. 

llopcfutK, in (he next monlh or two I will have fount! the time 
to <:lc4n up the comiTkcnls in m> suuiLi: Lodc for my fan Far- 
mar tar the IMx. and 1571011 157Korl541 mode), and win 
be Jhic to get ihcm off lo Trumut tor * and to yiHj. I'niil llurii* 
keep those tlUk dmes spmning. 
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CHIP CHECKER 




• Over 060 D«ttl ICs • 8000 Natjontf ♦ &g 

• 75/S4TTL(Altjt.l.h.i.itA> • 9000 TTL 

• 74/54 CMOS tChc hct, >c) • U-24 Pin Chips 

• 14/4 CMOS . 3" + j6" IC W»dms 

Pressing a single key identtfies/tests chips with ANY 
type of oufpu! in seconds The CHIP CHECKER now 
also tests popular RAM chips The CHIP CHECKER is 
available for ihe C64 or C128 for SlSft Th© PC com- 
patible version 13 $259 

DUNE SYSTEMS 



Willa Driv* 
St Joseph Ml 49065 
1616) 963-2352 
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Customizing C128 CP/M 



Patches for CPM+. SYS 



by M.G«r:ifiu/i-i:Tn 

Copyright © /VA^ Hi rnr lyuiii S\ stems Ltd. 

Cl28 CfyM mttdc rfli<rN on a RAM hasod oivrjlin^' ^^vMi'm io 

coniml the busk luikiionx of the computer. ThcM; KAM-txiM^i 

opt-riiiin^ s\Mcms hjvc vt-wr.il aiK;iniajECH over ROM-Kixcd 
nyUcm^ (ihuch a*t the siaiuiarJ Conunodorc h-bil Kcmdi und 
BASIC syiicim) in <tim it it very easy to make chanpe«. modin- 
i.4itiMEL^ aiiJ ^cncnil tuxii>iiu/jliofi h> p;ilchiiig ihc K-\M. 
whcreax an hPKcm humcr is generally rci|utrcd to male 
ch.ini^L-s tou ROM-hdscd s\%tcm. Ilii^ artKlc dcuK \«iih u num- 
bcr ol tairl> MmpU\ but quite uactixl nioUilu;atioii^. or patches, 
thiit am he nude to the (T/M Sx^t prtijznmi 

Before we gel Plaited, a bii of bockgmund info may be UT^eful. 
OlfKull). ihorv arc four verMons of ihe tT/\f biKil pntgnini. 
CPM*SYS, generally available fur ihc CI28. Thenc can be kicn- 
tificd h> ilw daic\ displayed when the rP/M syMcm firNi Nhh^ 
up: 1 ALU 85, 6 LHX 85. H DU 85 and 2K ma^ 87. Tlte I ALG 
85 version did not ^uppon etiher the R5-231 port of fhe 
I70()/I750 RAM cxpjndt-r Supjx>n lor the\e \^crc added with 
the 6 DK' H5 vcrxion, A minor bug in the primer routine wa« 
corrrcicd with ihe 8 D&l 85 release: and full suppon was 
added fur the 1581 drive with the 28 MAY 87 venion. The 
paivhin^ pi>int\ used in this article for the 6 mc and S dec 
%crsiuiis are identical. Thertfoft, tbc> will both be rcfcncd lu 
a-i Ihe "tH:r 85" version. 

Wkiv an- also numerous modified, "unofficial" and beta lest 
versions in limited circulaiion. Thi\ amclc ilcaK only with tho 

four official veruons, aitliuu^i the experienced prograiiinicr 
can eaxtfy adapt ttw techntqufs explained herein to other vcr- 

MihiHJiih the prooednRtafiurl> siMi^fufors^ard. I will assume 
thai the reader hjis a ccftain degree at understanding and 
familiarity with the CP/M environment Specifically, extenvive 
UM is made of the crVM dcbu^in^ utiht> siP com, (Of m^c to 
long lime C64 users is that this pmgntm has nothing to 6o 
w iih the sound chip ol tTu- \;inK- nanuv In this case siu is shun 
for "Symbolic lnsinji.iion l>:bug^er"j 



NoCe: Ihc addreatea given in this aiticlc fof the patch point<» 
refer to those obtained using SfD or an equivalent dchu^^r 
which K>;tds ihc file btnii^ |ukhed into the normal transient 
program area (TW) memory space. Consequently, all addrcxs- 



cs are calculated baaed on the beginning of the file being al 
address SHNf no. the normal Start of the tpa). If you arc using 
a Ikex file editor which calculates its addresses based on the 
hc^inninp of the file hcinp atldrcss isuch as fDFIIS. cn\t)^ 
you must subtract SIIN) tnmi the addrc?>M:s ^ivcn here in ali 
cases to pet The patch point for these other programs. For 

csanipic, address siJM with SII>, is otlually offset S,Mfl when 
you count it from the beginning of the file using r.nni^ (SMO 
from iht-stan of ihe TPAal $100 = S44n> 

StartlnjE nfT 

The fini step in customi/ing vt^^ui cP/M system is to hoot up 

cpf\i an^l enter the sii> cnvinmmeni. This i^ di»ne bv first 
putting ihe (P/M bout disk in disk drive 8 and turning on the 
computer or pix-ssin^ the reset button. Oncf the CP/M com- 
maful prompt viioruuJiy A>> appears, )ou can proceed to the 
rK'xi step. With a copy of siocoM on the same disk as your 
iTif' SIS file, type in: 



fID 



<r«turn> 



Noto: Vsf a htxckup nnrk ithk . t^o noi do fhh with your onf^i- 

thil iyj/rm JiA /niujor // hiU itkikc pt-rmanan dxan^rs to tlte 
nprralin^ xyxrfm. 



Alter a few moments, the 
like: 



scrocn should display sottKthing 



a/H 3 BID 
mxT KSZt 



- V«raion 

PC 
0100 



where //// U a hexadecimal number indicating the length of 
Ihc i./'w* s)s flic. For the 1 Ato85 vcnion, it wtll liave a val- 
ue of 5000: a value of MOO for the Dl-r 85 versions; and a 
value of fi3lK> lor the 28 siav 87 version. If oik of ihcs*: num- 
bers does not show up, then proc^ecd with caution becatise you 
may not be working with an 'onVial' release .iml ^nnie or all 
of the patch points nui> be ddtcrcnt. In any case, mark this 
number down becauv it will be needed at the end when you 
save >our changes. The # is sil)\ nomial mpui prompt: it is 
now awaiting your further instructions. 
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Thitwgbout the nrmanukr of \h\\ .irtKlc. 1 v^ill be rx-lcmnp (o 
three maiti SID i^uniniands, I \h:sc are d Jur 4Jj»pU> mcrtuw). s 
for set mcinory (i.e. ch:inj;c mcmorv bytes); and w Un uritc 
TTK"mor> lo tile. The \>nij\ Un cjch oi ihew coniinaiHl^ is 
iumiTCin/cd below. Nrtc that there is no tpiDe between the 
CovnrTurul kTk'T .ind ihi- firvi ar^unicni. hul ;i spate lor coriimd. 
AS 4ippiitublc) u required between ar(tuitKmv 



In all cavTN, <sran addrtss> and <r'hi iuhfrf\s> are expressed 
4^ be\udec&iiiaJ valuer and both addica^c^ vc optional. U 
<jf<irr drfrfirro h omined with the d command, ihc display 
siafts at the current pnigrjm counter value idehiuU ^{dtx ai 
OiOU. and with MibM.-queni usev i! re^uirtes from where it lasi 
left ofTj, while if <rnJ iiJJrv\x> is omitted, ibe next I ^2 hvlcs 
uiiJ bcdupia)cdll21inckOl 16 b>te%V. If <itart aJdirss> and 
<fnd adttrta> are omiiied with the w command, the values 
d:spLi>ed m siD's sign-on nwvsage under K and NtXT an: 
ukcd as the sian addim and end address respectively. For 
safct> 's ^.lk^^ It IS a jukhJ idea lo spctily the addresses e\phc- 
illv when modif>in|E bytes miiIi the % command or writing the 
modiried fdc wilh ». Thai way you do n*>l have lo keep iracL 
of the dcldull values Irum ihc pro^ain uHJiUa. Wilb MU, the 
pantmeter^ con be seporared by either tpaces or commas. 



YfHJ should see a displav similar lo: 

OSrO: 00 11 22 3S 44 55 €€ T7 11 9f 

ai cc DO u rr .."3Dur«. . 



folloi*ed by a number of iHher Hnet <€ rimilar lonnai. Thi?. 
fini line i% the logical to physical colour transfntion table. (If 
you have previously redefined sout LoUuirs using the 
k£YFKj.a>M uhhty. then all of the numbcpi may not appear 
euctly as shovvn.l Memory location i)^il\ coniains ihc physi- 
cal coli^ufs korrespunding lo logical coiour U tor lite tiU and 4U 
column displays rthey can he diffeirnt, if you <o ilestre). while 
O^ff conlains ihe physical colours lor logical colour t. in each 
byic, the low nybble. -*. contains the physical colour for the 
gO-column screen, while \hc hiuh n>hble, v-, ha?i the colour (or 
Ihc 4UH:oluinn -tcrecn. InitiaJl), all logical colour^ are default- 
ed to the coTTTspofHlinL' phvsical coloiir numhcrs. hence the 00 
1 1 :: 33 etc. 

Recall ihjr In^jical colour is sjvcificd for the backgrouiul To 
cluii^i. Uii^iype m: 



»5fO 



SiE> >*ill respond with: 



05ro 00 



Screen colours 

As pan of the ^un-iqi routine, CI2S Cp/M specifies the 

screen colours for ihe characters, background and 40-column 
border area. Now, you inusi adiiiii Ihat not cvcrytmc will hkc 
the purple chanKrteri on a black background with a brown 
border ihal Ihe wise lolks al tominiHlore chose as the 
dclaults. Our tlnht task is to change them into something a bil 
more palatable. 



On examining the rp'xt souiw code* one finds ihai the start- 
up rouune s|VLifies logical colour for the background. 
logical colour 4 for the foreground (i,c. the characters) and 
logical colour ** for ihe 40'column bt>rder area. Armed vmiK 
lhi& knowledge, there axe two ways lo change the defauhs: 
change the logical lo physical colour translation table or 
change the logical cohHir codc^ m the •>tan-up routine. You 
need only do one of the following changes, so take yottr 
pick. 

The first mcihtxl is |x-rhaps ihe easiest, ami is j gtHnl iniroduc- 
tion to the workiug^k of siu. In all ollieial vcruon^ of CI24i 
CP/M. the logical to physical colour translation tabic is in ihe 
same spiH, T>pe m the lollowmg al ihe MU prompt #: 



dSfO 



In this case, 00 is die current \ :i?tie for memorv I^KHion 5fO 
and_ is the Uicaiion oi the cuisi,»f. Type m your new hex 
value, say 16. (This will give a Mack background on the 40- 
column screen and a blue one im the HO-column screen.) The 
piiy^ical colour nybbles can be obtained fmm the following 
lable (QOie Ihe difTcrciKcs bciwecn 4(> and «0<olumn ntmlcsi: 



Hybbls ValiM Colour 





Black 








whito 








tad 








Cyan 


at. 


cyan SO col) 




^urpl* 


(It. 


purp SO col) 




Gcttoa 








Uw 








Yallott 


(It. 


yallov ao ool} 




0r*n9# 


(dX 


purp 80 col) 




acoMn 


(dX. 


yoiiow 10 ooi) 




Lt. tad 








DX Cray 


(dX 


cyui to col) 




Md. Ocmy 








Lt. Cro«D 






Lt. aiu* 








U. Gray 







followed by Ihe Return key. (From this point on, whenever I sin will resp^ind with; 

sj> lo type m sinndhmg. you should al\ia>s prc.si> lite Return 

key after^ards.l osri ii 



t 
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...\«JiKh IV ihc new mcfnory location (o patch. Wr will nof 
niAc any chan|Ec\ heir for mm. so p^c^^ Rcium a fc^* iin\c\ 



% t 



4 « 



05r4 44 

This IS the foiefround or chmcier coUnir livain>n. Ijpc in ihc 
JK\^ value, say II, for while charactcr\ iv 55 Tor green (like a 
fRcn screen monitor). Ptcm Rcrum a few nH»re limes until 
you gel: 

This is the Tmat colour liKatlim lo pakh. Il CJn be i^ntircd if 
>ou use 111 80-culumn di-tplay because the tKfnkr colour ift 
only userf tn 40-column mixltv U is generally mcni appealing 
to set ihn one to cither liic saitK colour as the background or n 
difTercnt shade of the tane colour (such as light Hue with 
ilari blue, li^hl a'd with dari red, etc.) 

After ymi fiave complctal ihc ehanj;cv. ivpc in a [vHjxI r.'l lo 
exit the s comniaikJ and return lo the niain SJD input prompt (ff). 

(Note that it is jImi piKsihIc to patch ihis colour tabic uvjn^ the 
C12X keyboard redefinttton utility KEVriGroM. Bear In mind 
lluit (he logical colour^ to he clumgcil to set the default scaxn 
coioun are the ^amc as thua^ outlined above,) 



The second patch tnc[tK>d for changing the screen colours amy 
*ecm a bit more complex to some bccauM' the precise location 

to mtxlil\ Llcpcndv ii|x>n the \cT\u*n of ( PAi that >ou aa' mixli- 
fying. However the tcchniL|ue is vmually identical lo ihul out- 
lined above. The colours arc actually set rust heforc the sign- 
on message by u^ing a ^ric^ ol e^apc codes printed to Ihc 
icreen acconlin^; to the following extract fnmi xhc source 
code: 

eall prtSug :eall routlna to print «lgiMn attAA*^ 



^ <<S"."*" ;ooDtrol-x to cl*Br eer**n 
{nof thii scro^n cloAr Iv not r«ally r«quir*dj 

db «>c.«Bc,ttBc :pr«fik for oatting color 

db purpl«*f5C .logical color 4 Cor for«grou&d 



db •■c,*ic,«sc 
tfb bl«ck«l«0 

tfb OOCOftCOOG 

db brovn4S70 
db **!"-" '" 



; logical color for bookground 



.'logical color f for bordor 



;cl«ar Hcroon 



Itlii* la tho ono vhich io roquitvd) 



« t 



CP/H 3.0 On tho 



tza 



» » 



db dato 
db craf 



db 



fillar 

•nd of woABaga 



(program r«iufl«a axacution hora) 

Note that the thrrc c()T<nir\ need tKH he specified in an> given 
i>rder. They may also be ^Hxificd u physical coIoutn 
than logical ones. The patch locations arc as follows; 



Color Coda 


Location 




1 


aoG IS DBc as 


2a wkY a? 


Foragroiuui 
aacic ground 
40 col bordar 


ItdT 2f<b 
2i* 2fff 

2adf 2f02 


2*01 
2oOS 

2o0» 



All three locations are intcrchanfcaMe hecauv the colour 
■ource which is actually set by a pi%cn liKaium depeiulN only 
on the value of byte. To set a given lo^^dtiun as a logical h»re- 
};niund colour, add S50 to the colour table nunikrs niven 
above. To spccity the locauon aji a lo^-icai t>ackgiuunJ colour 
add ViO, and for the 40-cofttmn border colour add S70, For 
example, if you wish to stwih itK- torcpround as logical 
coUnjv I. the background as logical colour 7 and the border as 
logical colour y. ihc b\ic \alucs would he S5I. Sft7 and S73. 

If you prefer to specif) the colour* as phssical coKwrs (i.e. the 
logical to physical volour [nn^laUun tabic i^ b>pa.sMrd and tlic 
specified value is used ducvily a« the colour), the correspond- 
tng addcpi arc S20 for the lorcgmund. S.^) fw the baLlground 
and S40 for the border. I'or example, if you uted valuet of 
&2L S32. S46 you would always have white characters on a 

red tKbjkground widi a blue -U>-column burden regardlevs of 
how you h:id defined your hifical colours, 

U»e SID'» I command to ^ the appropriate locations to your 
desired nc^ \alucs, (Don't lorgci to type m a pcruxl when you 
are done lu return lo the main $10 pnmipi.) It may appear that 
the lix'attom given for the tJEC 85 veniion arc out of sequence. 
I assure you, however, thai they are in correct MH|uencc. The 
illusion is created by the obscure method in which most of the 
tTM*MS file IS stored on disk. It i\ stored in l2H-hytc records* 
in reverie order (ix. the first record after the file header H 
pliiccd intii the high end of the conipuicr\ incmi>r> jrnl pn>- 
cccds downwards). Ttiis creates apparent disctHitinuities in 
pflfTs of the file which happen io ctw% over otw oi the 128- 
b\K' Kcord houiidariL's. A* we shall sec in the iKxt example. 
this can also create some minor confusion when trying to 
patch acrovv a split record. 

Tbe sitjn-on m(S\jl^^ 

As listed above In the excerpt from the cp/M lourre code, a 

sign-on message is included lordispla\in^: on the M.reeii when 

CPAI first boots up. In li^ dclault form, this is a very boring 



Tromoclor 
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t 



} 



mc\%apf consi'itinp of "CIVM 3.0 „/' etc. foHow^c! h\ ihc tbtc 
Being in the huhhI tor cu^roini/utitm. wc can viun^it th4> lu 
2ii>lhm£ thoi^clikc. uploabcHJt 50h>icsii)tjJ kngth. 

U..uMn'i a be iiiorc imcroimjf iur >our computer lo display a 
pmonal piwrlng <^ach time you ttled it up? How 4K1UI 
■(;<Mxl riKirruii^ l^rctl, this is HAL speaking"? Or "Dont 
bmhcr mc now. Tm thinking"? 






paiUiini; procedures for ihe DBC 85 «id 28 mav 87 vei^ 
Irttix arc simple and stniij:ht fon*aril, Wjih ihc DEC 85 ver- 
%iim, yiHi h4\c5.*b>k-Ntoplj) wilJiul jJdfcvscs JiU5 lo 2139, 
iNiH inchKfing an initial CTRl -7 (Sla» at S?ffM. to clear the 
wrcen hcli>rc iKiniin^ ihc mcs%afeJ \\\ih \\k may H7 version, 
vnu have 54 b>tcs fnim 2cO*) to 2c40. with the clear-screen at 

Vour custom message can he created hy using a varijiion of 
siD'stciHnniiiiHl. T>pe in %<sUin oiJtIrr\\> v^hcrc Mail jdike» 
b the previously nMMithmed value ti>f the cvfM version you arc 
u^ing, Sll> will rcN|»i>niJ wiih M>iticlhin^ like: 

2ros 43 

and will await your input. Instead of typing in a single he% val- 
ue as hctorL'. >ou tan i>pe m )uur desired am 11 siring, preced- 
ed b> j quote: 

"rr#d'a co«put«r. Good Morning.*, 

and followed bj a Return. \iHi' that you Jo not uye a liuihnx 
i/MHc, Anything entered after the fintf cfuoie it imerpreted at 
pan of the stnnt: I Mn>; a trailing ituuic w ill cause this i^uote 
mark to be iixtudcd m >our ntcssage. 

In addiLum. ytw JioiM ikk use trailing ^itoes unlc^yuu warn 
them to be included in your message. Sid will display the nc\i 
available UK-mon lotaiioii iifLt your ihan^c lolloped b) tlic 
currrni \aJuc of this location and the input cursor. IVpe in 1 
pL-ritxl and Rcium ifyou are dune or more levt ifyou uv not. 

You can include linefeeds /hex Wa), Reiums fhe\ Wld), ai 
well as ittber curMvr amt na-en coiiUol escape codes in your 
message. "Hiesc arc ta.-.K^i u> enter with the iKwmal % com- 
inan«l oudined above I'lw changing ihe Iktx ^allJc of individual 
b^ics. (When douig thi^. you should use ihc d command frc- 
quemfy to keep track of w hen: you stand. ) 

When you have finished your custom menage, check Nouf 
overall \snrk wilh ihc d comiiiaiul lo ncc how much paddlllg 
>ou should add: 



d2f05 



{91 d2«0b for th« HkX v«i»ionJ 



Your message shmiid be padded out with a scries of blanW<« 
ii20 byte values) until you Pearti $2f3« (DCC verxiooj or 52e4 1 
t\\\\ version), al which piiim y<Hi shcmld have a hex D hvte. 
Tlu^ U byie i^ very iniponant aib it serves a.s an end ul message 



marker. The pnni message rtHitine thai v^a^ called al the start 
ut Uk- sigDHHi will rcMuiic at the addrcvs imniethately loltow- 
ing this byte. Misplacement of the /crv byte lenninalor may 
cause a sj stem crash. 

Unfortunaiel). the signnm menage fcw the MU K5 scrsimi is 
iplit -H-i,:>.s a record boundar>. The fir^l half of the message 
consists of 3 1 bytes localed at S2Ke I to S2Xfr ant! ihc sec^wid 
tuill IS 24 bytes long ai S2SU0 to S28I7, The imUal cicar- 
screen is al S28eO and the bvie message temiriiaiiw is at 
S2818* 

It is especially imptmant in this case to keep track of yourbyie 
cvKini wlKn emcnii^ iIh: ikw nlc-k^agc betu^ if you ovenhtHM 
the available ^pace. you will coiTupt yotir s\sicni disk* 

The RlfWSPTOP key 

Mom people Mho an: tamiliar with the ofvrjtion ol the CI28 
in native mode (and for ihal matter, nwst oihcr ( oniiiKxIore 8- 
bit cxmiputersj use the Ht VMW kc) as mmI ul j suit' le^cl 
hunon to halt the execution of a ft \^Tr. or even a machine Ian* 
guage program. H*»wever. you ma> have alM> discovered that 
iMa does not work in ci'Ai mode. lHov« ottcn have you been in 
rp/\t nKHic trying lo abnn a program and pa-ssed Rl ^/^TflP 
iHit of hixbii.'i The equivalent ^cucral program exit command 
and soft reset in n»A1 is mil. r. iThat is. hitid down ihe Con- 
trol key and prcis the letter C ke} at the same lutKj 

This [R'xt patch nHHtiHos the ke> board deciiding tables in assign 
a \aluc oJ ctrla: (hex S03) 10 the Rt ^ sh m- key. The patch 
pi^ni is the same f<v all Ihax versions oi c. i2K OVM: $058c. 
Change the byte al thi^ kxalion Irom U (rcpre^scatmi; the ct^utva- 
leni of fny action) to 3 (wprr^nting a CTRt-C). That x ail there is 
to ihi^ |\ikh. Now when >ihi pres.s Kl vntom in CWW mode, it 
will be the same as prevsing cntL-Ctoenit a pn>gram. 

IhcKAMdi^k 

Tlic \M. S^ ( KM \erMon does not suppon the >L\M di-^k. w it 
will not be discussed funher for this topic. 

A> The di^k Ubcl: CPAf has a convenient method of assigning 
a name fi>f vohmie label) to a given disk \o help vou keep 
track **f which disk is vchich, ( Ihi* is similar totlic UHUcution 
of naming a Crmimodore t)c>s disk during ftmnatling. except 
thai it can be done at any time.) The tiame is assigned using 
Ihe CP/M StltoJ^ utility. 

The label 1^ nrcordad as a special entry in die diA dlrc c wy 
vhich is normally invisible. (You cannot see the volume label 
■when >ou di> a t>ik cornmaiiJ lor the disk directory.) Certiun 
opcraling s\ stem extensions make u*c of the directory label as 
a way of telling which disk is cunenll> in yinir drive. It can 
alM> be a simple iiK-lliud ol pcrMtnali/ing' your di?(k%. 

So Ar to good, or at Ic j^st one w ould think mj. But - and here 
comes the cruncher - you idiould he viary of assigning a name 






t| 






Tfontoctor 



« 
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lo >our R\\1 Jivk tiin\c M:>, Ilic rciiMHi for ihp\ \\ i^ujic \im- 
plc: u aJfiuid) haft a name which i> abo used as a Hag lu con- 
Irol formartinfof llic RAMdUL on n ^\Ai^in hool! 

When CT/M lxx>t% up. ii checks for the presence of ihe ram 
i!i%i by KtokinfE for ihc ram expansion controller iRVX) rcgi&- 
•en. If ii find^ the Kix^ lu be pfCMrnt, it then checks the lir^t 
cntr> of the RAM Ji-^k tlimrU^ (or a 'key' lo see if the RAM 

expander hu^ been mnuJi^cJ as a cp/m kam disk. This kc) i^ 
the disk fahcf "OrTwiNE \OH'\ (Von Eiiwinc was the chap 
rc-^piMiMbk' Tor adapting cp.'M to run on the Cl^Hj 11 ihi\ bNrI 
to not tuund, the bool pnK-o\s will *fonnat' the ram di^k b> 
ending the director) jtch m ith hc\ $c5*" then writing lhi\ label 
to the firM cniiy, thu^ losing jii) djta uhich niay be present 
abrady, 

Theie arc a number of reavxi:^ why you may warn lo prc\er\c 
d.ii4 v^hcn v\Michinj; mi*h1c\ or rch<nrtinii >iHjr vsMcni. The 
muu obiiouv i% \o recover Jroni a s>Mcm cruaJi. IJ you had 
crr^tcd or edited file\ on (lie RAM disk without \;ivtn^ ihem lo 
a tlopp) and then subM:i)ucntly had a cra^h of hxkup, >ou 
may want 10 be aUf to recover the files when you reboot Nor- 
mull). evcnihing m iIk- K \m ili**k \\ould be prr^cncJ, imivid- 
ing you did a reboot by pressing ihc reset butt^Ki nKHneiuarily. 
Ilovkcver. if you rename your ram disk using SET, the key will 
no longer be prcNcm and )our data will not be pa-Mrncd when 
gnin^r from cp/m to CI 38 mode and ihen t>ack again. 

The oec ftS version is relatively simple to patch. The MAY 87 
venkm is a hit more diMuuli. again duo 10 the patch area 
being ikplit across a record boundary. 

hor \1k dla: 85 ver^on. tlw label ia located at SleSa to IcM. 
To sctf 11 type m: 

Ute text "LKiykiSL vun ' ^liuuld be shown on the firy line of 
the dump. The first character is 3 hex $20 (Asm space) which 

indicates that the i-ntrv l\ .1 directors label. The last bvie is a 

1 . Neither of ttiese libould be changed. Uiic SID'h a command 
to change the levi of the label: 

•late 

Sid should irspomt with: 
lasA 43 

To make the changes. t>pc in your ikw di-sk label as a text 
cntn preceded by a quote such as: 

"MUSS Dtaic 

You must incliMk die quote mark at the bcguming. You hive 
eleven diaraciers 10 play with and The> slumld he in the form 

of a legal CP-*1 rilciuinc iIpC. all uppercase v^ iih m> reserved or 
special symbols such as ? or *). Unused locationa ihouM be 



padded with spaces. When sini liave pn?ssed Return. sir> will 
displa) the iK'xt Liti:iiioi> aiea, which might be: 

IBiS 01 

Type in a period (J foOowed b> Return to signify llM you are 
fmiibcsL ^'ou can check your handiwurk b> typing m dlc59 
again, 

Now tor the MAY 87 version. The first three characters of the 
label (KKTk are ai Skid 10 IcfT. while the remainder <wi\l 
^UN> arc at SIcUU to Ic07. To see this, type in: 

dlcOO tcff 

To change the label, you will have 10 change tt>e memory 
bytes in both locations, ttcaring in mind ilie number of bytes 
used al each hvatiinr Tins can be done in iwo Mep%; 

Rfst, use sicfd to change tTw first three bytes in the label at 

SIcfd III UlJ. Remember lo type m a period s*hen >*hj have 
changed these three bytes to return 10 the SID command 
prompt. 



die nrmaindcT of the byiea at 



ScLi^nil, use slc<KI to 
SkUUlolcU7. 



R» The drive code: CI28 CWM WIOOMtt^ly assigns ihe RAM 
ilisk to drive M:. While this is good for most applications. 
Ibcrc arc a few CRM programs imosily those designed to work 
under much older vcr\iun> ol civM> wtu4:h will not accept any- 
Ihliv over D: tfsuch as M:) as a legal drive specifier. In this 
ca*c. it if' wi>c to change tlw kam disk assignoieni to \onK 
other lener, such as Br, C:, or D: (assuming that ynu do not 
tiavc a dl^k dnvc already so assigned). Changing the dnve 
assignment invtoves making a few palehcs 10 Ihe DRlvhTAHl F 
and opiionally to the code which checks for and inilj:ilj/es the 
RAM disk- First the UKiVKUULE, 



For hiAh the OBC 89 iod MAY S7 sersions. ihe nKiM:T\BL£ is 
located sianmg ai S65L It contains a set of 16-bit vecu>rs. one 
for each drive letter lo the disk fiarameter block for each of 
the dn\cs, (If no dnve is aiaigiked to a given letter, the vector 
has a value of Oj The first Ibing we must do is to "de- 
alkK.-jtc" drive M:, This can be done by setting both locations 
$669 aiKl 66a to 0. The second step is to allocate another drive 
letter to the raM disk. The vector hn the ram disk uj'ti is 
SIVM. Translated 10 low bylcAiigh byte format, ihis becomes 
$96 and SIh. The correa addresses 10 paith depend on the 
desired dnve code according lo the following tatile: 



DrlT* codm locAtioa tot 



at 



fb 



A: • 



653 



<S2 
«S4 



TKmsoctor 



66 
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C; 


fi55 


€56 


0: 


657 


i» 




• CSf 


4fta 




C9b 


4fto 




(M 


4»« 




ftSf 


440 




fid 


442 




eo 


€U 




fifi^ 


444 




447 


444 




44* 


44tt 




6^ 


44o 




4Cd 


Mm 


!:. 


C6f 


470 



vcnion. S2fcK for Ihc dec 85 vcruoo anJ S2cec for the MAY 
venion. Nomially, itih bvic will have a vriueof S10 which a>i 
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Byttt v«iu« 


•OCOL (acFMn) 
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420 


FRTl (d»vic« 4) 


410 


nT2 (d»v4C« $1 


40i 


M-23a 
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• .\«t«; you should avoid Attigning drives A: and E: to the 
Rwt Jisk hociiUMr this nm uium.- prohlcmN wiih o(licr ct/m 

\Nheil CPM IxHiix up a checks lor ihc prcNCiKX o( Uic ram 
disk, ir 11 j« not foand. ihc conrspondinp vecfof in ihc 
i>Kl\i:T\ni r is rcii»oscd and replaced wuh (). l^is proccs* 
a^uunca llmi the ram di%k i» a&signcd to dnve M:. Since we 
hive jusl changed (hi*, asj^ignnk-nr^ il i* dcsirahlc toch;m^'t: ihe 
\tx\oT jdilros which will be updaicd- Nuic ihai ihiN p^itch i* 
not ciwntial. but wi?1 ensure that you wilt not he jbk lo acccs** 
the HVM disk dn\c cinie if you do m« ha\c a RAM diUk 
m^uJled. With Uic DEC 85 verxKin the patch address is SlelO. 
anil with the MAY 87 \cTMon. ii is SIcKV In Nxh cases, the 
contents of thiit byte will be W*J representing the pinnter into 
the DRr\TTABl F for drive M:, This b>ic ^houlJ he changed to a 
value fmm the lollimn^ uMc whidi oofTrspund^ to the drive 
letter installed above: 



Multiple devke assignments arc also pos^thle. f=or example, a 
value of SIR i%lQ + $08) will assign the primer to both 
devices 4 and 5. In the case ut the RS-2M port, some fiddling 
with the serial protocol of the printer may be rci|uired to match 
the default baud rate and vimmiumcaUun protocol of the 

CI2»'*iis-2j:pon. 
The driie seartb chain 

\\ hen cpfti k kHikmg fur a program, it can kcan;h up to four 
separate drives betort It gives up Us Kaich and refv^rts the 
equj\ alent of a "fik not tound" error. This sequence is vailed 
the "drive seaah chain". In the t)Ec 85 and may 87 versions, 
the drive leaich chain paiMtiKicrs are livaied at $I26H to 
126b. while for the alo fi5 version, the search chain m at 
S0e68 to Oe6b. In all ca*et, the default version of ctai con- 
tains the chain: 00 It li u which corresponds to searching the 
currently logged drive only. 

To set the M:an:h chain, the following byte values arc used: 



1 

Drlvtt 


co4« 


VAtU* 


t>riv« cod* 


valu« 


00 ■ default or cuxr^ntly logged <Uiv« 


a; 
C: 

B: 

r: 

0: 

a; 




dl 

d3 
dS 

d7 

d» 

dd 
df 


m * 

■1 


•I 

«3 

m^ 

•d 
9i 


01 - d£lT« A: 

02 * drlv« a: 

1 . . . atGj 

10 ■ drlTtt V: 

tl m fU,ltt[ 

For example, if ihe search chain wiis set to: 

00 Od 01 02 



The rtt'faull printer 



When cT/M boms up. the CPAI loptca! t l^tfcvioc ii^. the printer) 

It a^M^-ncd to the ph>sica] <*evice prti (i,e. scnal pon pniUcr widi 

device »4i. You may wish to use another primer device, such a* 

device 5, or even an ks :*: pon devKe as the default pnnier, {I 

base two separate n^muior* hooked to my system: one lor the 40- The default drive and uwr a 

column scnren. ami the ocher for the S(), In soitk- ^ jvs. I use the 

■MKolunuj M^reen as a tempiirary prmicr.) The patch MUc^ to 

change for the default printer assignmem is $2«c4 for the AU3 85 



lad you typed ifl a Imnsicnt comnunJ such as pip. CWM would 
search the dctauli dnvc lor Ihc corresponding file {NPCOHh If 
it was not found on thi* drive. CPAt would then tr> dri%'e M;. If 
11 was still iK>l found, drive A: would be tried next, then dnve 
B:. If it was stvll not found after the complete search. CFAf 
viould repon back wtth a file mn ftmrnl emw. 






After tT/M boots up. control is returned io the user via Ae 
Console Commami Prixrcssor {CCfcoH) which waiis for \our 
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comnKinJ. TTic CXT pfompt UiKc^ tIk inmi of "\usrr num- 
btrWdmt itutr\>" (Mich a^ 3M>). v^hcrc u^/- nunU^ti and 
4^'ir /(-frfr itprc u cm ihe "currentT> loji-^cit" u^c^ am (3 in 
thix ca-M:> iiiiiJ Jisl Jnvc (M: m lh^^ cum:). When you I'lrM Jkhu 
up. this i* normally «f to twcr area on drive A:, giving! the 
faiiiiluir A> ptntnpi In Mitnc cases, such a\ when you use *>nc 
dink drive lo buot fruiiK but More niini of your progRum cm ii 
(liffcrcni drive, vou may vn\h 10 change this Jefittili u'ttin^ In 
avuiil hdvuig lu change ibc ilnve assignment cxplicitJ) each 
time you bom tip. 

The defauU drive on a coUJ boot is conirolled by the byte ai 
SI22f for Ihe DEC K5 and MAY K7 scrsions and ai S<)e2f for the 

ALU m vcnion. The v«luc ol this byte is U lur drive A;, 1 for 
drive B:, etc*, up 10 f for drive P;. <TTiUb>lt. which ctkK up at 
ofl^ $13 0} [Ik s>s(cni ^.oiurnl hUi^k <M H>. ts also used by 
Ihe CC? during the warm boot routine for eslaMishing the 
dctjull dnve after eMliii^ Irtnn .1 tmnsicni pn>gnmi. The valtie 
at ihi\ loc;iium is u|xUiic\J c;ich lime you explicitly set the 
drive from ihc riT by issuing a <dri\e Utier>: <RHuni> 
comiiuuid, Ihis patch only sets the initial v;Uue used iifter a 
cold boot.) 

The default u?ber area on a cold bool is contntlkd by the byte 
m SI230 for Ihe DEC KS and may K7 versions and ai W.V> for 
the ALb 85 vexMoii. The v^lue of thix byte ranges Iruin U fur 
u\CT area 10 f for u^er area 15. It ends up at offset $14 of the 
SCB and i^ 4lsi> us^'d by ihe ctr during a wann boirt. 

txlindid I5HI support 

In \o!unK R. Issue 03 of Tranuuror (November I9R7j, I pie* 
Mrmcd a patch tor the alg 85 and ULC' K5 versions of CI28 
CnM ihai would allow full use of ihe capacity of ihe ISSI 
drive. Aa I meniioncd at the lime, my I5KI di^k hmnai wtiuld 
not be compatible with the "ofnciaK' Comnuxlonr version <i^. 
Ihe MAY 87 <PAt release). Since some of vou mav have 
obtained the MAY 87 CTAI rvlcaw ^incc making my initial 
patch, you may he wondering how 10 access the I5HI disks 
made with ni} versuHi. Hear iu>nhc next patch allows ilw ma^ 
87 venkm to read and write these eariy 1581 di^s. in addition 
10 the "*>fricud" I^SI disks, I The patch |xiinis ,\n: alsr* re|XMt- 

ed ft>r the ai ci 85 and ni^ 85 versions lor the beneru ol fhnse 
who missed them the first time anumdj Change the hsietl 
byics to the 'new byte vaJue" to complete the p^ch. This 
ptfch fiddTes with the disk parameter labfe entries for the 
l'KM>\ cj\ 10 disk lype I Ml 1 512 siLUfrsj. so yt>ti wdl lose 
compatibility ^ith this type, but gam an wv^ di^ instead. 



■yt* v^ua 



ADO as CSC as laur a? 



1404 


21» 


IfOS 


1405 


21(4 


U09 


140< 


21^7 


iroa 


1412 


2173 


Ifli 



00 



Corrivlinj; t>ui:^ 

This firud pUdl cures ■ bug in the \\ r. ^^ \cr\H>n which pre- 
sents you from cvcxuiui^ ^u>[oin >^502 machine language rou- 
tines from within (Tfh4. (Ye* Virginia, you can switch the R502 

on fn>m wiihm (T/M n^inie and execute 85(0 mavhine lan- 
guage programs!) The error is at $5cab which ends up in the 
BHis H502 |X»riiiin of the CWM i»pt'raling svsienv Change Ihis 
byte from a Sc3 to a Uk and you are utl Ut die races with liiu^ 
function 30, group 4. suhfunclion 9 "Uvr call to R502 Code 
KiJiiiine" idcM-Tihed on page 700 and 701 of ihe CI2H Fro- 
urammen Ke/t^rrtm' Guidfu The 8502 code at this location 
should he iMiMf-TX)5K hiii the Sftc for the JMF* instniction was 

MNiicJiuw M;raiiiblcd auu a Sc3 by Ihe cross assembler used 10 
create ihert>utine. 

Or nine up 

Now thai you have eornplelcd all of ttte patch work on your 
svstem disk, the last thing to do is 10 save a copy of it. This is 
done with SID '5 w command: 

w«p«« ays, too, ■■■« 

where //// is the address rhjr >ou <.<ipied do\^n frt»m SIDs 

M^-uii x-Jccii jX like betEiiining of i)ic pruce&s, lo refresh your 
mef!w>fv . It should be 5iKK) for the KVG H5 version. MOO for 
Ibc !«■( 85 version iw 6300 lor the MAY 87 vcrsum. Alter MI3 
ha* rewritten the file, it should display a me**atr stmilar to: 

where yyyy has a value of UUB8 for the MQ 85 veruon, 00C6 
for the DEC 85 vei^ion, or 0004 U\f the MAY 87 version. After 
you gel this mcssjgc. you cancvit sid withaCTRL-c. 



To aee ihe effect of yow chamai, you imist do a cold sy siern 
nrbo(n ti.c. with the modified tVift^sridi^ in drive Au pre»» 
rrRt,*<Fnler> or the rrsei bulion). When CTAt come« back 
on, your chaD^» should be la force. 



01 

n/a isai («ot«c u xmx. aumgj 



(If by somcclunccyOBhaveiMdanem>r in the patches, and 
you cannot get ct/m 10 reboot or it doaa lonieihing unexpect- 
ed, it is proKihh easier to sian with a fresh copy of ihe old 
unnKxlilled c/'.u«,s>^ file rather than trying to fu your niudi- 
fied one. It U alvi wi*;e to wait a sN^n time hcforc you copy 
MUir modified iTf\\ s\siein 10 vour Kxii disks to check ihal 
yiHi have iH>t created any 'hidden* bugs by your patching 
attempts. » 

At Hrsi glance, this ;micle miy ieem to suggest a fannidable 

task, esivciall) Um the novice CIVM ivograinmer. However, it 

» fully recognized that not everyone will want lo make all of 
the changes meniioned above but a ctmibinaiiiMi of a lew of 
thcin can add mmiic mce custom KHiches to your cp/M environ- 
ii>ent. in addition, ihenr an: proKiNv many m4>rc changes thai 
sould be made m the fmn of patches. 1 leave these to olher 
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Whafs Really Inside 
The Commodore 64? 



by Milton Bathurst 



mk 



Book IT* low hv Ilm Rutterfidd 



FuNtshed by DataCap, 12 Thxhal. 8-4543 Fetteur. Beliihm 



\ \ atiuhic in Stffth Amenta ffvm: 






SihnrJUr SystemM 

OffH^ 94. 25 fdrfHvW ftd. 

FO thKi5694 

isheiiiU, SC iMfiiJ 

i7(U} 274*4646 

242 fhigrs. i29.9S LS postpaid t/M 

This booi i% ;i tomplftc and rclduvcl) ^^kkI ilisiMembly. 
w ith crusifc- reference niaierial. of the ROM of the Commodore 

64. Tho liilc i\ mi^icadin^. \irKf ihcrc arc man> oihcr things 
iiuuk ihc CummtxJurc 64 ihji couU be documemed: VO 
chips, sfvcijIi/ciJ BAM areas, and pi>rts ipin conncciums and 
IcvcKk 

Bare bones disa\M.-nibh 

The Nx*L conlains little clw jjian finmilhc Rem di\a^\cnihl\. 
The author ha?> dune hi-i job carefully; data lahlcs are not 
cofifuwd 2S, code, nnd the tricky bit enin- nvj^is an- tauphi 

well, "Inimcduilc" dala. where numcnc values mi^hl Mxne- 
limcH be confused with address Iragmenlv are generally 

A disawmhiy ts nai in itself exienMve documcntnioo of ROM. 
Whjt would he needed to ik> llie job better ib dcuukd re^t^tcr. 
mcmor>' and condition code requirements for the various rrni- 
tini,-^ 4N ihc> .IK k'lKored and J^ ihc> e\tL For example, here"* 
dotuincnralion of *uhn>uline tHRtiin: Before calHny, a pointer 
fT\"TPf>r\T1 K, address Uc\ 7A/7B> needs lo he p*>inijnt! at the 
address \o be scaniKd; no ^peciiil ^egl^tcr or flag yrtup i^ need- 
ed. When the subroutine returns, rrpisters X and Y will ik« be 
dtMurbcd: repisier A will ctmiain (he ncvi character from the 
te\i stream: txitujmui wdl now point at that character, flaps 
Z, C, and N will be alTccicd according lo the nature o] the 
ehajacter 



If you dor 'i have ilctaiK like thost* iif the aKtve example, >oti will 
need to do a ^(h*I deal o( rcseaah hel^>rc usny^ hkH a subruuUtie 
from your own pnijmun. The btr* doesn't see ^och detail as pirt 
of its ta.sk: don't enpe^t to gel that intumiaiKHi Jicre. 

The boiA documents ROM, not HWt.. yet M»metimes Ram 
contains impi^inatit ttnlc. lor example. CHRCiti, mentioned 
above, i* tn RAM; at startup time, it'* copied from E,1A2 in 
»M\i and plaied at S0(>7:^ in kam. It's an iniponani subrou- 
tine that is used frequently by bask. Bui if. at >-ou look 
ihrou^jh the Kxik. you sec J\h MlOiy. no amount of frcii/ied 
flipping of pa^cs wiU ;>huw >ou a subroutine at that addre;^. 

While the c<xlc i^ annouicd alxHJt JiO percent of the machine 
language instnicttons cany a brief note - it doe^n'l explain. 

and does not scl llie slagc. When yiHi Iih>Ii, al du' math subrtHj- 
lino, you muM know m advance how Jloating point numben 
arc set upon the M. You musi know that floating |^unr regis- 
ters will be pre-loaded with the valuer lo be handled. When 
you lor^ at the code for a commarKf tuch at UST. you must 
know that- upon cnin. \Uc C flag will be clear if LIST is lol- 
lowed by a non-numeric characfer. and the 7. ftag w ill he set if 
Msr vtands ali>ne The book won't lell you any of this: it 
a*^ui»cb >uu know u m advance. 

Crovs reference 

A useful pan of the boiA - not a-adily available elsew here ■ b 
a crus&<rcfcrence of the ROM code. TTiis %% carefully d<>nc. but 
\t\ fragmented: jumpsi. branches. suhnuiiirK- calls, voiUmx. 
"cMcrnal" addrcsM:^. aixl /irro page addresMrit ate lifted ?*cpa- 
rniely. each with a special pnrfiv: and to add to the pmlifcra- 
lion ol crms-nr fere nee enines. ihe basic and Keiltal Ru\t\ 
each have iheir ow n «ct of listings. 

ira^nKntcd uJUic-vso arc gcnerully handled wrll, and arc car- 
ried throu^ correctly to the cross-reference area. For cvample. 

..xtmtintird tm /wee 7/ 
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Macro Set 1 for C64/C128 



from Xytec 



i 



Avaihhiffrom: 

Xyttv 

1924 Di\hihlff0 

Sail tranusLo.CA 94115 

$29,95 VS.$5ms^H.addSiJS0fi*r Canada 

Macro Set I from Xylcc i* a L-ollfction of \4>mc ?6 ready lo 
luc .UAUikbki MHim mdc ^ubtouutKit aiul bU d-v^cniblcr 
niifcL*n>», !i N currenMy jvaitablc for the hfcrfin and Cttm- 

nuhion* .\sirnthifr Ocwfopfr Svsirnu while vciAion\ lor other 
popular avscmNer fomulN <MKh ift mt or Buddy) art sakl U3 
be fonhcoimn^. Ii provide^ ;i rc^iililv uvail^ihlc aiut ca\\ to u%c 
MMiive of a9h?tcnihJcr \uun:c code for man) Lommon lask.s 
CiCCO hy prognfluncTA. 

Macro ba«lci 

For tbouc who arc IntcrrMcd. an assembler mai;ro is really jusl 
a stmple way 10 in\cn a length) piece of siandardi/ctl si>uac 
cock imu >uur progmm b> 4>ccit>iJig a name wiili perhaps a 
few piinnwiers. (Not all a^^cmh1e^s vuppon macros, bul mow 
of the tx-tter onefk duj bach nine the macro i^ called in jour 
assembler source code, a full copy of the represented code j« 
iiiMrneJ inlo itK- ohjett cxKle, 

hur exampTe. if you wanted lo open a disk fUc. you normally 
have ID go through a M:rics 0I siep^ u^mg the Kemal stTNAM. 
seTLFS (SETBANK on the CI 28> then open. Instead of manual- 
ly repeating the\e ^U'■p^ iMch time you warned to open .1 tile. 
you could sel up a macro (let's call il DOPEN) which contained 
all these xlep\. Vi>ur assembler xouree cixle may then ctKltam 

MMibc luic^ wludi may took wtiK'iliing liLc (remember, ihc 
nnia^ for varioti\ awembler^ \\ different): 



, <lls|,dwio«f . GbVkMlf 



fill 



where filename, nk#. dmcfft and channeUF are your 

ters for the i:iven file. Now, each time ^our assembler \eev this 

line, it takes the source code i which may be several hundred 
lines lonp) associated with the macro UOfTS, inserts the 
parameters at the appropnaie s(»t, then in\cns the cixlc into 
your main F^^nun. By keeping sets ot often used macros in 



flandard reference libraries, you can greatly redtjce the cfTori 
in wrUing iw\'- asscmHer pr^i^T.irns- 

The libraries 

ttacro Stt t does just that for you. Macros and subnMittnes are 
provided for most h(Xi\ckecpin^ functions such as screen 
pnmmg, keyboard input, disk Hie W. etc. A net of EQUATCS for 
the standard Kemal entry pt>inls and other memorv and s> sictn 
values (colour codc^> is ai^o piovidcU in one ul iJic libraries. 
(However, conspicuous by ii^^ ab\ence N \uppon for some of 

the penpherals and pro^rammmg aKan many people need help 
with such as sound, graf^ics. mice and ram expansion units. 
In addiliitn. although the disk Lihel states "for the ComnuKli»re 
64 and 128". there is no su(^n for the C12K Ml^olumn vdc 
chip, bank s\^ itching or the C 1 25*^ enhanced Kemal set-) 

The macros and cubroutinea art divided into six hbrarie^^ 
which can he combined with your own assembler source ci»de. 
(One very nice touch is that the mantrMJ states that pn>grams 
containing code developed from the \vicc routines may be 
freely distributed wiibout atinbution. Alter reading the condi- 
tions of many compilers, code libraries, etc. that b;4si(.ally stale 
you ^.tiuiot sell any program dcvelojxrd usitig system \Ti. 
without the permission of Mega XY7 Corp.. this is truly a wel- 
come reliel!i En the C'A[>-M version, which I tested, the 
libraries were supplied as shtjuential data files. (Oilwr ver- 
lions of Macnt Set I would presumably have library files 
compatible with the given assembler) 

The fTAirr lihrar) ci>ntains the Kernel .kkI system iQUMBS 

as well as general work areas, pseudo 16*bit reginter han- 
dling routines and general housekeeping (i.e. screen clearing. 
curwH positioning, etc). The tNn;T library contains a tairly 
sophisticated macto for keyboard input. The Rs\m library- 
has niv handling macms and suhrouimes. AKITH contains a 
variety of math and number conversion mutines. The 
lihr.ines [>vtH MP and 1R \(.l: c<mta»n det>uggnig and n>unnor- 
ing type rouiirKS. 

These libraries contain quite a number of lestad and 
debugged a s s cm b ter routir>es. some perltaps of more use to 
the everyday programmer than others, but all well thought 
out and easy lo use. 



Tromoctor 



70 



Apt! 19W: Vokma 9. lieu* 4 



Stmtt I«* yiHi uwe pMudo I6^hit rrgUicm for maih, a^fcI^r^^ 
ui^ Olid general puqxMCi. It docv this h> M-iimg up a scnc^ of 
kn* b)ic, high byte memory «it>ni|zc piiir\ whk'h can be 
dirrclly manipubiol by a number of ihc nukrus <iiuj ^ubntu- 
liaes. Hiis reiuurc aukcs 16-bil nuth on ilkc Hbii 65)ix pnvcs- 
*or a real snap !o \i<^. 

\\ hiil\ up dncft 

The documenWiofi (or Pw^rammer's Refertnce Guide, m 
I tbc> cull i\\ is u fairly c^tcnslvo dcs^riprion of ih^ uvjjbblc 
macros aikJ subruutincs gruupcd by libriiry iTioiJutc a-s \«dl u.v 
iKce^^ary background info on how the libnries imenvf with 
fjtti other. Also irKluiled tnr mittic of the basif conccpcs and 
is^umptKxis used in <kvelnpm|! the rouiiik'v for each library. 
Ihc m;irui;il is indexed b\ rouline function as well ;is bv ^icncf- 

dl subject, and UKiiuka ^ LiAiing of keywonb and ieser\cd 
svardi u*ed by ihc various nniiincs. 

The emiy for each macro or lubrouiinc is accompnnird by a 
shon ilestripium of its function, sp^vul pjvpjrjiion required, 
which rc^i-slcrH are affected and Uic %>tiUA. Mom are alio 
accofnpaniod b> a shon example of thetr usape. If I h;k1 i>ne 
compJaint about the iiuiiU4d. it vtoulil be Lhal most of the 
exantplet nv too brief or vague to yei a realty pood idea of 
whai they arc try ing lo do. 

On Ihc do^^n side, ihc >NUppfied aource code in the libraries is 
very kpancly cominciU4:d. li itoenu that Lhc degree oi ^om- 
meminp ts inversely proptinional to the eoinptcxity of die ttni- 
tines. The ca.sy ones air explained, uhilc the complex ones 
have link or no comments to ibem. It 1% nftea very difTlculT to 
flfUir out ^fchat iv going on. ThK w especially impon^nt if you 
want to modify any of die routines. (It \\ al^^ay^ nKC to under- 
si;ind what you an: Iryinp lo change, just to he sure that you 
afc aoi removing HiiiK-diuig viiai!> 

A few detailed examples x^ould also he nice. Hoia abimt a 
compile satn|ric source code pnigram that calls a number of 
the macroa and subrouiincs lo demonstrate their pntper usage? 
ScNiicthing as siinplc as a kcqucntial liic reader would malce 
use of a fair numberof ihe imcfOt tad iubRnilinei«. 

Parting wordt 

All things conMdercd. I would fecocnmend Macro Set t lor 
all levels of a.sscmh1er proizrammen although it v^ould pitlba- 
biy be of most use to ihe mtcmicdiatc level programmer wlio 
IS competent enough to itmterstand the basic concepts of the 
macro system, but not l^uiic up t4> writing reams ot source 
ccxle. Beginners should be able to follow along wtih the aid 
of a goixl book on assembly programmin^z, white advanced 
users may lilkC u for the "why re-invcnt the wheel" feeling 
that ii provides them. 

If a venloR of Macro Set t 't%nai avarhbte for vour favourite 

j^vL-mhler. an experienced pro^raminer sl^^uld K' able to adapt 

ol lhc existing uoc^ with little ditTiculiy. 






tnsiile the Comtruttirrf f)4.,,.fit)m pu^c w 

LOA »$7I, LOY IttA** ia correctly translated m U3A <TA371. 
LDY >TA37I ... well, almost ciinectly, sioL-e most assemhleii 
would call for the "9" symbol lo be rruined. Indeed, thai imme- 
diate syniN^I is Uk ki"i: ihn^ughiHit ihc divissembly. 



Even tricl^ier ctxle is hanttle*! inteUigenth The IRQ vector table at 
SFWB s4.-eTns never u> be orlercrKcd. hot the \\vk conecdy 
deduces that it's reached with an offcet frnm Sf^CBD. thus: LDA 
TDAP>B KA .. IJM TDAP9B-7A. Bui the juthor didni man^a 
to unmvcl all the cuduig pu/yJes. Hf example, there *% a scent* 
ImU KifHinj: refennKC ti> SVFEA (not even in koM'i at addics» 

AFD6. NiM until yini nek the call to SAFA7 ilium SAEEEl 
would you realize thai the call h made with a vahie in A of SB4 or 
jiRMk-T; Ihnmph s<Hnc txld anthnviK, this iiciK-fjicN a value m V 

of S68 or above. Hk $9FEA fffeimce could then be changed 10 I 
UM $AOS2*S6R.r A052 i« the T.ihle of addnrsses for fuiKlnHi 
call^ but yuu won't find it addrcvwd ail) utikci May. 



If you know your way around 
ROM code, you U find it a 
handy compact reference... 

Other hoiika 

You might warn to consitJer other K^oks in the same vein, to 
suhsEituie fort>r supplement this inlomialHmt Tuo other refer- 
cfKes give ROM details. 

The Abacus book the Anaumty t^the Comnunlare 64 gives a 

disassembly plus discussion of programming considerations, 
with several cvomples ol code. Ihc disajhscmbly icoiitauiicd 
in an appendix that i% larger than the book's main text) is 
commented, but not as Ihonniizhls ,is uj \Miiit'\ ReaHx instJe 
ihe CimimiHiore 64, and no wiu!>^-jcLi.fcncc i* nupplicdL 

CcHiipuic! booki haa poMiahcd Tool Ku. Kermi and IwM Kit: 
BAStc. both b>' Dan lleeb. These two hooka study Ae MM of 
the ComnuHlcire M. and that of the vie 2i), which has identical 
logic flow, to conaiderabic depth. T1ie code k extensively dis- 
cussed, not jusi eommenied. Not all of iIr- Rom code is dis- 
cu^Mrd. but tnosi of it is there. 

Summary 

Whtif'i Rfi/tiy /nude the ComnuHi*»re 'W is ,i complete K<*M 
listing. If you know your way around rom c^kic, >ou'II Tind it 
a handy compact reference. 

Although the disassembly contatna brief comments, this Ny^k 
would be lough slediling for ieamers. It assumes that the a-ad- 
crknowsijuitea bit about ihcM'sofganizationbefoTrband. Q 
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SFX Sound Expander 



SID dethroned 



Rr%irM b» Kidiarit Currlo 

SFX SiHtmt E:qkiikier and Oisk. SW 

5 OctavtfuU uzf kr\hHjrd, S90 

MIDI MfffuLe. iS4 

MiOic Makfr kfyhaant ovtrlay, $10 iCM twht 

FM Ctmtpti%er and t.Jiii>rtJi\l. SJO 

SFX Pwfcrammers itrfrrrmr Guide. S/0 

iAI! pruei m US dt^lars^ 

Fnirv X \hi\ic. 5/9 »' Taxfnr 11114. Santa Maria, CA, 9,U.U 

Call iS(Mtt 4^7 .<4J4. In CA.iait fWi.^^ VJ_H>M2. 



One i*l (Iv HKxr iKitabfc raMviicf Di0Cbnvaoilon64 ha.s Kx-n 
ite eiu'elkni Noufid genersrinf capatnliiics. llic ptwcrful sm chip. 
containing thnec owiiLiUu^ \%iih U^jr wjvcfiinns i\Kh. Umr-pan 
cmirkjp:?!. and illtci, is almu^t a cunipku; %)ntlw\u«:r ui u single 
intepMed cacuii. Since ihc InrnxliMiitn itT the C64. synihcM/cr 

UxhrH>k>j:\ has ovcnAcn .uul |\l^scJ Mix Ktr huilim siKiikl 
generation, however, few prrvmal compuien hove ^uqxKsed or 
even CL^ualled the CM. (In iik:i. <hiI> r\^i) ivmUU ^tkruc lo mind. 
One i& Ihc /Vmiga, with finir chonitcK ul N^»[>kd Mmttd. The oth- 
er is nnf .in Atari.) The SfX Somd FxptwJfr hnngx ti> the CM a 
diUctciu lomi of soiukt ^ncraiiun: Di^iLdtMS>iUhcM&, 



A brief e\pla 



Tin: four \^.uoroniitof SD's osLill:it(>n. arc more iw lc*s fined. 
Thi: filler can be uwd u> remove or etuphdM/c baimunich or 
overtone*^ of the wavefonn aikf thus ^mitibie variou^ muxkul 
in\irumcMi\. 11ns pnn.c^\ i% called \uhir4vnvc sjnitwM\\ 
AmHher meihtid of Mnind generation involves the »lding 
to^lhcr of luntioiiiudK r\'ljk\j \inc»Aavcs in vann^ amounts. 
This u refened to a^ additive ftymhcMit'. 



EM N>niheMs is un altogether diflercnl proccvt. Sounds 
created hy having ovillainrs frequency mtxlulale each other at 
hiLih rales m complex ^dys. Bcin^ mon- ihan the gt'iiile l\t oi 
vibnio. sidebands arc generated: andb> varying ihe itpccd aruJ 
depth of motluKilKtn. ami ihc inicKonncctionx Urtv^ccn ihe 
oacilluiofN, vcr> complex mjujuI^ can be genciaud. Oo all this 
with dighal technology, and you have Digital v\a Synihestv 

TW* titme proceit U iwcd in the electronic in^tninient?i made 
bv Yamaha, arxl not surprisingly, the s¥\ Sound [i\pandcr 
employe a Yamaha IC. 



Hardware 

The ifX module i& not a nev^ product. It %% manufactured by 
CimiiTKidofe UK and has been a\ajl:ihlc in Humpc for several 
yean. Feam A Musk is no\^ importing v A mu^ic prudiict*» to 
die U.S. Phy^^icaliy. the vnc Sound Erpamirr \s a lar^^h car- 
tridge, rescnihlinj: ( omniodorc sMfljjir li'icr imntukv It plugs 
into Ihe CM cxpunMon pon and has a tmp door mechanism tor 
the insertion of a comp.inion \ni>i cartridge, available sopj 

ratcly lor 554. The ^bi (and sottuarci is not compatible \htih 
MUM carrridge^i from Paispon. Sequential, :tnd oihcrs. On one 
side of lite \f\ m^xJulc is .i mm^Ic R(A phono jack for audio 
t»uiput. T>iift can be ctwnected to a stereo or instrument ampli- 
fier A special cable Uncludcdt atlii\^N the soun<ls to tx* played 
on a tclcviMon by routing the signal into the CM aiidio/videu 
connector. 



On the other side of ihe SfT m<x1ulc \\ a connector for 
cvlcmal music kcybi^rd. alM> available separately for S80. 
This keyboard has five octaves of full-niTed piano kcyit. \\ 
exn\*mel> lipht weight, and compact. It is neither velocity- 
seiuitive iiur pre^Miie- sensitive, but its 'aciion' is quite good 
and noi at all 'vfuiihy* as electronic leybo^irds tend to be. 
Although It IS an option, this extcmaJ U'>tx.)ard is essential \\ 
you want accciK the Expandfr\ mart sophisiicaicd features. 
The ti>p l\fco TOtts ot the compuicr keyboard can alM> be used 
to play Ihc Fipaiuicr. A Mutk Maker keybourU overUy is also 
axaJTablc at SIO. This is a pfasiic cover uiih mini si/ed piaiM> 
kc>s that overhang the computer keyboard. Trying tu play 
music wttboui rhe overlay or the futl-M/ed keyboard is 
cMrcriwK clumsy, lediiuis, ami frustrating. 

The SFX Sound E.\f>tinttri has niitc 'voices' or stmnd genera- 
Ion, each consisting of Iwo oM;illalors icallcd 'opcraton' in 
rM tem^inology), with enve1<*pc and phase gmenitors. The 
soli VI an- supplied with the t^ii/mndtr provider eight voices, or 
%ix voKcs plu^ five peTru«ion rounds. 

Soft ware 

The disk ihai votm-s \Mih the sn Satmd Expmider u«cs the 
form of copy pmccction that abuses the disk driver while load- 
ing, the drisc emits chattering, grinding. ma(.hinegun s<iund 
effects. Since die software is useless without the hardware, and 
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The hardwire \s inAiriiely morr difficult (if noi tmprH^iMr) to 

JupliL.iic, one ^uc^lH1n\ the ncvtl Ua uii>> <pn)lcctH>ir Soiuhn^ 
ji umpic coftimand to the drive, bcfmc loadint; Mifl«afc pnv 
UMc\J in rhis mannot, cjh minimi/c the violence. 



QhrllO); clu9(l); flikxl(133) : cloa«15 



MiJi cjijsc the drive lo he si 
prok-vted ihiN \fcay is loaded* 



y qukicr when M>(T\Mne 



Ontr the ^/ \ ^uflworc as niiuui)^, a nwnu line ippc«r^ jX the top 
of the vreen, with a windrw m the centre di^i^ayinp two mii^ic 
\U\c*i with ha^x and treble *.lel\. ITiis windo\^ shows the mttc^ 
ai ihcy arc pJavcd. 11k C64 tunctiiTfi Leys an: rcprognimmcd lo 
pnwi^lc curvvr up and down, Letl ami ri^hl. iiKRMsc and 
<kvtca:ie, or on and oil -^ applicable lu the choM:a opcrMion, 
plus 'FmcrV Thi^ an:inf!en>ent laim fsninj! used to, and t Mill 
lirhl nuscll tniii^ io use the fiornitl curM>r and rtium keys. The 
menu vlet^iont arc SOIT. SYVra, RHVmM, RIH-; and DisK- 



Htt^hli^iinf SBIVP with ihe curvjr/function Lcy^, a ikupnJuwn 
MiTid(i\% jppcan wilh a number of optioni afTe^iin^ the m<x]- 
iile\ operalHm. W hen N o tmri Is elkked \x\, the HHind sekxied 
in the swni window can he played m^er the fill! keyhoard. Onr 
fmiyr Choul prin kIos major and mini>r chorils hy prexsmj; wn- 
gle \xy\ on the Iowa iwo row» of ihc conipuier kcyLxunJ. or 
comMnMion^ of left-hand ke\ s on the external ke% hoard. (Thc« 
aa'actuaUy iwo-fm^crutuHd-s, hut wh> i|uibbk?) 

The RH\ \n\\ wievieil inK'ra<.is with xUw and ftriju-uJ Chord 
lo pniduce aiito-accomp;mimenl. Mrmnry holiiv a chord after 
Ihe keyis) are released. Prevsm^ ihe space har cancels a Ikcld 
chord. The external kevNurd can be ^JUI, ami dilTerenl 
vmnds assigned lo the upjx'r and lower portionv The split 

pomi call be any where on itic kc) board. 



The SYKTHmeiiu pro^liles a letociitm of 12 dirTefent s^mmk. 
The disk comes with two 'voice' or sound banks. Additional 
vninds Lan be created usinjz ihe companion pn>gram f U Ct»n- 
pttMi atui ^tumd ttitu^, available up trMCly, The kcyboanl 
can be shifted H- I octave. The notes displayed on the music 

slaves don't change w[icn the osta\e i\ shilied. The keyboard 
can alM» he transposed 4^ and -5 scmitt>lK'^ Played iKXei ut 
then di^pla^ed at their new poMluln^. I n\<-mhU' halves the 
nambcr of voices and assi^nii two ^\fthc^ lo a key. The two 
voices oir then shghtly de-nmed to 'fallen' the s4>und. The 
Rin niM iTKiiu pmsidcs percussion a^cumpanitm'tU in various 
styles: Pop. Rock, Bwsanova, Country, etc, TTw drum soundl 
jri- uncannily rcahslic icspceially the cymbalsK unlike the 
~ boom-chika-boom" of other inexpensive ekclfonic rhythm 
mits. It beats a mctn>nomc any day. When the p^'rcuvion is 
attisc. the number ol playable soiccs drops to six. 

Svmmar} 

Tlie inerall pcrfi»niiaiKe of Ibis jMekace is excellent- The soft- 
viarc does have a few \horuomings, however The menu high- 



Itpht har doesn't 'roll oser* from top to bottom or vice vena. 
When )ou aMth one end. you hive lo go thmugh ail the selec- 
tions to get to die other end. A fudlmentary tone control in pfD< 
sided from the computer kevKurd. hui it would have hem 

nke lu have kuhk yoa of pertonnaiKe contioU, perhaps using 
;t i<>v stick or paddles, lo alter the sounds in icalMime. And 
w hat C 4Hiimodorc UK cillt a U«r*s Guide is pitfwtic. 



1 



However tlK-MHimlstlui etnaoMe (nm the sf T Sowirf £qMndir 

ixtK siinpl) asUHinding in their n^alisnv The Strings sound i»eqic< 
ciall> n>n\invinj:. panicu1aH> when Fn\enMe is enabled. With 
the optjcuvil Cimipi'Hf Uiifi'i ptogranu any souikI lound to be 
less than ^rtsfactory can be shrrpcrf to the user's liking, A CM 
owmT rrall) ean |>ui ioi?at»er a I)\t hke instr\in>eiu for a friictioa 
of the oo»t The mighty siD has fxvn dcthmned. 

FM Cum|M>?»er and S4>und Kditur 

The compaiijon votiware for the SfM Soumi t.xpiuuUr is 
^'M Ci^mpnvcr and Sound Ediutr. This package enhances the 
pcrtornunce nl that device, and is indis|vrisahlc if >ou want lo 
ciealc your own sounds and coiiiposiUuns for the SfX module. 

The Disk: The software employs the abusive form of copy 
protection that hangs the disk drive head armind. While there 
may be s(»mc jusiificaiion for copy pa>icclinp this disk, there 

can be no justihcaoon lor the method UMrd. After Ihc imtial 
bead banging, a screen appears with the choices futitor and 

Cimipo^^f- After making your choice, ihc dnvc is subjected to 
nvyr^ .ihiisc before the sc?i\*!ed pnu-f;iT^i appears. 



KM CiHnp4)ser; The skimpy booklet that Commodore tK ji 
in^ls *,alls a "User's Guide" claims ituH ihis pr\»grani is 
"powerful, yet easy to use'\ This i\ only half true. The C«mi* 
poser is indeed cxin:mcly p<iwcrful- It is also extremely diffi- 
cult, and a user must be pnrparcd to ^pcrkl a lot ol imkc expen- 
mewl ing aiKt teaming its features before attempting to create a 
fnusLcal 



FM Ctmtfhtiii .iltnws the sfX SifiiaJ Expuridv/ to pity 
lime-part uiumc scorca polytimhrally. In other words, each part 
can have a different sound. Wth the eot^ipanii>n xitim car- 
tridge, eaeh voice can receive notes over ajj> *»l lb MIDI chan- 
rtels. An external Mtni-equipped device can set the tempo for 
plavback ivtii>i cliKkl. Any voice can \k lunicd on or off for 
playback, or slightly detuned from the oihcr voices. 

In its "clear memory'' state. iIk Lotftposer has n^mory 
available for over twelve ihousand "evems'*, For composition^ 
many common ami umommon lime sigiutlires are supfvined. 
iTKrtuding 5/2. 7/16. and 9/4. Notes can be entered from the 
computer keyboard, the optional external kcvhoard. tw via 
MlUt. Rests are entered w ith the space bar. Wlkrn enough notes 
and rests of the proper durations have been entered to fill a 
measure of llie time signature selected, the [Kk'^Kim juloinali- 

cally insens n har line. Key and time signatures can change 
within a piece of music. Triplets and dotted m«es are sup[>ort- 
cd. The instrument sourki can change w iihin a pan. 
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A voir cm^Tcd with this pfogr an i can have all the comTntkwi- 

;il music m)<jCKin>. Kil^irdando, \kkr/jmdo. Itrnuio. ;iruJ 0;i 

THpii are a Tew of ihe ienii\ used in the inMnictii>n hooklci. 
i >h% iously. a more than vupcrficial knowledge of muNic icniii - 
[hiJogy u needed k> um: ihi?. piu^diii id it!, lull polentml. 

On plavhsni. ihc piece cjn he **hified +/- 2 OCiavcs or irun^- 
|KMed 4/- 6 Mmiloncs, DiHcrcnt sounds can be avvigncd to the 
nirw p^iris fri>m a lihran of 64 souikJh. Adiliiionjt s«>und?> can 
be crcdicd w uh ihc Uiior iksc nbcd bckm. 

11k livl oi Iculunrs givv on and on. and perhaps lhal\ the 
main problem with ihiit pntgnim: it tries too hard, The mv 
(..illoit Ixcr ^ (kiiiK JiKsn't prn\ujc riiiich ^uut.iiKC .itid [lie 
<^in^le help screen imi t ver> helpful. Sldl. jud^m^ fmm Ihc 
demo piece included on Ihc di'sk. someone vi dhn^ to vpcnd ihc 
uixK iiece^tsao to Icam tlm program will be aUe lo du Atihu- 
in^ thing* with the ^FX SnunJ Exp<M(ifn 

k\l Sound Kditiir: ThiK program cnaMcs ihe uwr to develop 
new unindA for Ihe sflt Soami Ex/HinJrr. The miuthIs cre;ttc\i 
can be UM^d by ihe /hW Catnt>oscr or ihc bauc M>liwarc included 
with the Ejipamter. It al«o functions as a ntne-voioe polyphonic 
s J nihcM/vr» 

The SEIW menu alloWftSk'lecHon ol oik- of M ditYi-Ttut mhmuIv 
1 he upper and tower pofliunst ot ihe cAtcmal ke> b^tard can have 
two difTerent Miund\. Ihe kcyboaid can be split j[ an> point 
The kcyboaid cmi be slulicd up ot \ky^n one octane, or uiats- 
posed. With the Mint interface. Ihc unit can both send and 
receive inloniultofi over all U) ManclunncKand ' Onmi". 



Fruit Machine: This \% a silly name for a very clever pnve^s 

K^iiIkt than assemble j sound Irom scratch. dic screen sho^s a 
di\pla> ximilar 10 a &I01 nuH.'hine, widi Utile pictures uJ dillcr- 
ent musical InMrximenUi. Entering ihe Go c^wnmand. the 
wheciN an: *kpun. When the) ■ilop, }ou can pre^s a few kc>s 
and if you like the sound, go 10 the Hdii screen and male 
adjusltncnu, or %piii a^am for a different sound cotnbitulnm. 

OrtreHl My main compfairu .lNiue iMs software is the method 
of cop> pruecUun employed and the non-intcgraied ruuure ol 
Ibe aepameprDjEnims tf >ini*re in the Editor and >i>u wani 10 

eill 10 the Owv*"*^'"- 1^ computer must be reset and llie kuJ- 
ing process, nrplcte with drive-abuse, begun all over again. 



With iLs many fcMvea. two khortcommg^ of the Compt»fer are 
espcciaflv anno^ini!. On pfayKlck. the scnxn displa) is sialic, 
^tucl wlierc^cr it wa» when ihe FU> cohuiuukJ wa^ ^ven. Uus 
makes locating one's mismkes cfifTiculi. This is compniinded by 
the fact thai when >ou chan}*e |iafis, lite displa) jumps to ihe 
Tbtan of the new pan. rather than the location corresponding to 
the |ioim wl>enr the pa^viiHjs pan was exiled, runherrnore. no 
nuinbcrutg ot the nicaMUO t» pfuvukxL Tlw ukadci^uacy ul the 
Cf"N/V'\er instructions may dtscourafe tonic users. This v^<xi!d 

he a shairK'. because it ap|XMrs to be as po^erlul as LiauiKd. 
Diligence and piUience on the u^erS part an: clearly necc%»ary. 
In contraM, there '^ linlcii^fnvl fault wnh m the S*'titui l.diufi\ 

The snif EMpander. combined with the f'Jift'r (\impii\rr, 
brings M.iptu<iUC4ied ^ynthcMs lo CM owners at a vcr> low 
price. One wonder\ why Commodore didn'l make thi* product 
a^ailabie in ihiscounlr\ s(H>i>er. 



I 



I 



A simple drum sci|uencer is iiwluded. with fi\e pcrvussii)o 
sounds lite mm^ucikc is 32 steps w iih no pruv uiuu lu alter ibc 
length Of save ihe sequence, Drum events can be eOKlvd fiom 
the keyboard a stop at a time, or in real iinu:. Ten diltcrem 
dnim 'kits' are provided. Again, when dnrnis are aatve. the 
number of manually pJa> able voicxs drops to su. 



The F.tfii Smitul scfen b the real meat of this profnm. With 
it, any ol the 64 mhukIs in the library can be tailored lo the 
user's liking. Becme of the complexity of fm progriimmiiif , 
cenam ci>inpri»mises aie made. The i^creen piescnis several 
'sliders' afTecting various qualities of the sound. Britliam't and 
Xoiurrw are self-c^planalory Whcic the compromise i* obvi- 
ous IS in the Envelope cuntrul. lojocad ol Ibc lour-part 
envelopes familiar 10 sir> prtigr;im«>erN. a single sliiler selects 
one of 255 preset cn^cltT^Kv No graphic reprcscuutioil of ibc 
envelope h offered, 

Bcsausc an i-M voice consists of two oaciltaiors. comrcd over 
the two pitches is pn)\ided. A i^lider labelled EifHinder con- 
trols the tccdback between the iwu oscillators. Lach o^tllalof 
can have difTerent levels of Mhram and/f>r TrtmotfK Once 
you've got the M>und just the u.i) sou ^s.int it, it can \k stored 
in tlie library and the whole library uved to disk. The first 12 
sounds oi ,L 1ibrar\ can be sj\cd as a 'V^>ice Bunk' lo be loaded 
by Ibc lUpander's ba&ic wllwanx 



Also .naiKible: SFX Programmvi's Rtfifcme Guide. SIO. 
This 31-pagc booklet, titled "Das Mu^ik Gcschalt", is 
more specificalh aKnil the Yamaha VM>52<» IC than aKml 
the sh\ nu>dulc. The chip is accessed in a manner similar to 
Ihe C12H 80 column vix". Only two localions appear in 
nicmor%. one to write a r^^^tsier address, and one to write 

the data or read Ihe chip\ status. The booklet provide^ no 
programmm^ examples in h5x\ or any other Ml,, but iUk's 
explain the numerous rcgi*iler> and functions. 

1 am in the proceaa of dissecting the shX module, and the 
following information is. ai this lime, feniatjve: The matrix 
for the evicrnal keyb<»jrd occupies eii^ht kKations at SDHW- 
SDHJ^, The YMi526 livc!> at SDI-^u. Incomplete address decod- 
ing causes images' of the matrix and Yamaha chip lo repeat 
throughout 1/0^ The VM.i^:'> is not ckxked b> the comput- 
er's clock, but instead ha^ its own 3.SMH2 crystal OMTillator. 
There is ihc possibdity thai a variable clock can be substi- 
tuted for Tine tuning or pitch-bend. The connecior for the 

MttJl cadridpe appears 10 have some address lines swapped 
or shifted, lliis would explain the incumpaubiliiy with third 
party MIDI canridges. As more is learned about this piece of 
hanlv^are, 1 expect programmers on ihis skIc of the Ailuntic 
will develop their own software for it, perhaps a CI28 ver- 
sion thai makes use of Ihe larger memory, burliin windows* 
high resolution ruutincs, and W colunui di^lay. 
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X-10 Powerhouse Computer Interface 



Control the world with xoiir C64 



HiirclMiirt rfiifw b* Nucl Ntnuin 
X- 10 FoHrrfumsr Computer Inteifaee 

IHSA UOrandAir 
Sonhvalr NJ 07647 

A\mlai>it jfom strx-fral umnes inciniimft 

Ci'mpuirr tytrrtt, Inc. 
22292 North Prpprr Road 

miBl TWtSF itr 3I2)82'S05H ionitrtt 
il2'S82'2S82 itrthnnaJ u^M$anctf 

S.*9.95 iVSiphi.\ \iupim\K m ^itUer i^^iS^tatuioji 
RfijmitJ 0>4 ior C l2Hi and one 1541 1^7! dnk Jnvr 

When I /ir\t Kiucht a houM:, I wanted lo .luhiiuiik- every* 
ihinip. In those da)s. computcrN were uto expensive to dedi* 
catc to mundane things like tumin; li|lili on and ofT. So. I 
scl up ;i vyMcm using logic gJk-s. prtJgrammed irvm a pjuh 
panel. I nin extra wirc^ where nectled. and used three differ- 
cni volia^e levels. I numuincJ the s|>ini. il mn the leticr, ol" 
Ihc elcctncal codo. The hunlwarc cost ubout S25 Tor eaeh 
lighi vw-itch. 

With the X- 10 Computer Interface and u CM or T J2«. anvonc 
can create a muvh more cI.jK>i,ju svstem than m> ^>rjpnai- It 
wjuuvi vcr> huie eleitrical experience, no extra wiring, and 
only u few minuTcx to instiilL Unlike my logic gjiic cin:uil, u\ 
cjv> lo progratn. ll features an onboard clock/timer and full 
haner>- hack -up. 

The computer is uMrd only to iniiiali/e the interfiK-e. Oncv pro- 
punmed. it can he dis».imrK-\.icd Irom the ctwnpuiet and oper- 
AVcii m ttand-aloikc mode. 

The Computer lnlBfftc« originall) iulj for over SI50. In 
utcni year^ ix'% heen draMically diiicoiiaied fhrouph mail 
order ouikis, At S40, ii\ close in cost to Uk iiaiiUard XIU 
cuotrullen. 



The X- 1 1» System 

X-IO (fomierly marketed a^ ihe H\R Svsiemi controls i;i> VAC 
lights, lamp&. and appliances hy u^in|E power line earner trans- 
mission. In ^lmplc terms, an interface ks plugged inio an elec- 
trical outlet in your Houm:, Under prugnim or manual control, 
the interface vnd^ a coded radio aigiiaT through the I2U vac' 
wires lo "control modules". 



i>- 



The motfiiles aa* usually small h^>\e^ Ihai plug into wall 
lacleifc. Tlu dc^ii:e tu be controlled plu^s into an outlet on the 
module. Another \\^ of mtxiulc is desipncd to repla*.e stan- 
dard \^all switches for incMdescciu liglit*. 

The modules desijined for lighiini: appliL.iij.ias van turn the 
liirhis on or oil. and dim to any selected level Tlie lywne mod- 
ule^ Lan he us<J tnr noM-imttJctive appfiatices. things that 
dimt have molors. Appliance modules arc available that can 
wftch any load up to SQO waHs ITiey um- small relays, so 
loads connected to ihcni i,M\iKA be dimmed, 

Ea^'h minlule hax two dials or rotary switches. One dial xelevis 
lcuei:> fnjin A to P 1 16 pi>vMbdilie»*. The other dial selects 
numN.'rs from *>ne lo sixteen. Each mi>dule can have one of 
256 addresses voiii|.Hisedirf a kner and a number. 

There are many types of intcrtacei ivtiUblc to coiurul mud- 
uki. Moit have a sekctahle letter address ranjte, using a 
switch or dial. This is «.j|k-j ihe hous<' ohIc ' Ilie Uoav: 
code is noi changed dunng nonnal operati*iii. Depending on 
controller siyle. there arc fimr to sixieen switches. Ra^h con- 
trols a module, which is alw set to the preselected htnise 
code, by number. There may be additional switchei^ to dim 
miHlule* once they are sekck.1 Some intcrla^.ci pruude 
»wiu:hesi for "all lights on', and ort»erfunctionv 

\kisi imertace*^ u>c manual ^witclics. Some leapond to remote 
comrol devices, either infrft-nd or radio. Special iniertaLCs 
answer the phone and tespcmd to touch Owe Mgnd-t. Uher^ 
are designed for me with burglar alarm systems. Some have 
internal chxks iuid can be pre-pn»granuiKU lo execute com- 
mands ba-sed on time and day. You can have many interfaces 
In diffcrcnl kxralions to conin>I the same, or dilfercni iniKlulcs. 
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Tkc Compsttr fnterfkre and the < 64 

The Computer Intcrfact ha« eighl manual swiichc» and a 
DIN connoclor It comcv wiih a special DJN lo user purt con- 
ncclur lor the C64/C12ii. anil a disk ol ^uUs^jrc in 1541 
formar A nine-volt battery K ii^d as a power failure back- 
up. 

To uw ihc 0>nt|itacr Inicrfacc. you jusn plup i\ into a wall 
outlet and ihc C&4. A% witb any ti»cr pon device, be surc 
ihc tompuier is turned off before conneeting Ihe caWe. Stan 
llic *upi>uii pioi^ijin b) Ki Smug ihc hr\l program on the 
dKk. 

The pri»gniiii i^ lflr|ffly menu driven. You OH uic the keyboaid 
or a |i>>Micl to ncIccI menu opli<ins. After Mllnf the internal 
eiuck Vkiih Lhe day ul ihe \hcek and Ihir-. you'a- a\ked tor i 
hmixe code. This code will be used wi^ the eight muntinl 
\vMUhe\ lo allow iho inicff.Ke to work as u stripped tlown 
>t;indjrd controller. At the main screen, bclcci the insrull 



The pmpnim djsplflyi a *menu' of mom-* in a house, and front 
and reji Mews of the cxlcnor Ihf lunK'v of the t^Kfrn^ ^jiil 
be changed. So. if you want n nnxlule in the den, you'll pnitvi- 
bly ehot>sc the spanr' mom Y<Hir family n>om mij;hi N\.omc 
Ihe 'guest' room. Actually, you eould put all the iiiuduica in 
one *room" for ease of pn>crjmmTnj!. regardless of their loca- 
tions m Uic hou^. 



In the cmpt> uH»m, you'll haveae««nd pi^s^iWc mtxlulc UK-a- 
tions shown a» red squares. Some axe on the llour, others iw 
Ihc walls iind ccilint* \^ you ptuni to j ^^ju.irc ii lums ^Ahitc. 
After >clccUng a square, you ehuo^ Uutip or appUatiLt. Appli- 
ances can't be dimmed, m> the pft'^'ram won*t give you that 

opUon It >ou choose app(uxtw€. 

Next, you're gi%cn a choice of lamp> ^r .ippti.mccs to use. 
These are cute pictures made of multicolour sprites. Ilicre'fc 
a v;iriei> \y\ appliances or lamp styles if you picked a tiH^a- 
tion on ihc flour Wall locaUons give you onl> wall Umpv 
Md thermostats. Ceiling* can have hanging lamps, nr the 
generic custom' ap|)lijiice, a "C?". After insialljiion, 
these pictures will appear ai their locations whenever you 
select this x\Mm\. 

Each m^xlule is assij-ned a hoiT-t- v <Kle im! number. The pro- 
gram will dcUuJi to the nc\i j^jjl-ihlc number tor the houM: 
code assigned to the Computer Interface. But. you can change 
tilts u^ .iij> or the 2.S6combin,nion\ One ol the features of the 
Computer inicil^ii^e over otJkri interface^ i^ that it can use 
many house ci^lcs simultancouxly. 

After laMalling the modules throughout the house, you push Q 

to go hack to ilic nuui screen and select itpvratc. 

Again, you move thnnigh the house to select a room ami mod- 
ule. The program lets you sd on and off tmics fur each nHidulc. 
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You can select sescral times for each device. You can also seleci 
one cycle (now, today, or tomorrow \. m periodic c>cles (every 

d^y or specific days). You can select lull oi dun percentage lor 
l:unps and wall switches. You can use e-^act time, or 'security' 
for sliffhtl> \:iT>mg on^oll times. YtHi can alM> gnnip scleral 

modules ii> use die ume timed cycle. 

When done programming, ju-sl turn off the computer and 
unplup the Computer Intcfface. A red \jea (Light Emitting 
Diudc> on the Conipuler Inlcrtacc Hjslics slow I) w hen tlw unit 
H disconnected from the power line. 

Plug the Computer Interface into any outlet. It wttl tiuw cycle 
the mixlules nou'nc pn^jznimnwd. You can iiKo use the manual 
switches to coflirul modules one through CJght that share the 
interface's house code The Computer Interface cannot dim 
lamps manually. 

A feature unic|ue to the Computer Interface is the ^Kty lo 
save the stored UHxlulc program on disk. You can keep several 
progranu for various piirrHKcs and load them into the intef^ 
face, savmg joystick time. ITk disk also has uiihtics lo control 
devices directly and change the time in the interface without 
usin^ the iiK-nu progr.iiTi. 

A4nn1aces and disad^ anlagaa 

The XIO system system is incredibly easy to use. espeetally 
if jouve ever spent hours crawhnt; jIh>ui under a lh»usc 
installing a wired s)\tem! Just plug things in and move the 
joystick. The wall switch tiKxIules Jo require a screwdriver 
to remove the wall plate and old switch, Ylhi 11 also use wire 
nuts (supplied) to connect the module. Be sure to turn the 
power off at Uic breaker panel betorc instulhng wall switch 
mfxiules, 

1 prefer the wall modules to conventional switches, even if 
they aren't controlled b> interfaces- The X-10 wall mtnluK^ 
are push-on. push-otT. It's easy to tuni on a hght with your 
hands full- Just puxh on the switch with your elbow. 

A disadvantage is a small mechanical slide jusi below the push 
butiiin. It turns off the lij:h( \\ hen puslicJ \o ihe left. X- 10 says 
this IS a safety feature to disconnect power when replacing 
lamps. lt\caqrlohii thai slide switch instead of the main but* 
ton. U' the room is dark. >ou ma> try st-ccral presses before 
divnvering, by touch, that you've iiudvenenily moved the 
slide. 

You canmrt ilim lights manually al the switch, It can only he 
done with an interlace. You can u\eride iIk mtertace bright- 
ness levd by mming the conrrolled lamp on or crff. Lights to 
be dimmed are first uirticd on at full inicrisiu. then bnnight 
ikmvk to the desired level. 

The lamp modules that plug into outlcis have stnnc extra 
intelligence that was a pleasant surprise. If you have a lamp 
plugged into a imxlulc. >ou ^,\\^ turn it on by throwing its 
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iivifs Wntvr M: Tin>cwtiri%. Inc. has a-kj\cd OVrM Writer 
04, 1 otoS'iuwd \*ord protcvsinn; lystem llud includes a 
WYSm'Yfj pirvic\* mode and high ^pccd icxi entry, and 
imporb and cxpom icM und graphiLv ihc prog j t a m also ic^- 
luits a lOO.OOn'Wnrd. Niilt-m ^peMinp checker a wide variery 
ol \pcLial cit'cvl fonts: mail rncrgc capahililv; exu-n^iM- Kir- 
nijitm^ conirol: a *raM-dnin' priming mode: hcaOci^ atni loot- 
iTs, Jtvumeni chaining, lo prim JtiLunicnK af unlimiic*! 
Icn^; ^.in^lC'ke^^uukc command upuoti; ii»c ol nHHjsc. joy- 
Slick or keyboard fo move aiYHimf ihc Avwmcnl; imlinc help 
iCIfCnsH Gcos WnwrM is supjx^ncd b> TmwwMrks' kcluiical 
Mtppiwi leam M no churizc to registered uscr%- The pmgmm 
Irvu tor U9.95 US, Onler fn>m: TinK-v^orks. 444 Lak^ ( .>i.k 
Kd.. IXcdicR IL6UU12. USA. 

iitos ^^^ilir M: Iifncworita» Inc. has nrlcawd Geos Wrmrr 
64. a CFOS-based wmd pmce«inp 'system that includes ■ 
ttVMWM. prcvict^ rmxlc and high speed leM enlr), and 
impom and cxpons lexi and graphics. The program also fea- 
bina a l(Xl(X)()-\*t>fd. hutlt-in ^[vllini! ^.hcckcr, a wide \ariciy 
of special effect loat^ mail mer^ ui|xU)iUi>; cxtcn&ivc tur- 
maning control; a 'fasi-dnift' priming mode; hcudcr^ and f^wit* 
erx; diKun>cni chaining, lo pnni dcKumcnis of unliitulcd 
length: Mngle-ke> stroke command i>ption: mc of mouv. joy- 
Mick or kesNkird lo move around the documcnl: online help 
KcrcenKv Gtt/x Wttwr f>4 is suppuned by Timeworiw* technical 
a^>pi>n team at no charge lo rvgisiercd users. The pn>i:rjm 
hs^ tni s4'>>;_^ US. Order from: rimc^^ori*, 444 Ukc Cook 
Rd.. Deerfield, IL600I5. USA, 

iBVCSlmvnt Uratcv> on the <'I2«: Sinilegy Soflwaic has 

announced the rele^isc of liw Snuu-JuM. a ri2K market liming 

progfun for invc^lor^ in stocks, bonds, mutual fui>d\ and com- 
modities. 

Acci>rding lo Strategy Software, the t>-pical technical analysis 
program jpproathL"* ihe in\eMnf\ real ifueMion * \«hich \inil- 
egy b bcM? ' only indirraly. Ii allows the user to chan i^sue 
prices agarnsl one m several indii..iiL^r\ so that he iw she can 
stsuall) puk iIiom: that seem to call ttic tunxs in llw iiuxKcl, 
then use them to time trades. But. says the company, these pro 
gTan1^ fail to give a hard OK-usure of how much a given strat- 
egy would ha\c paid (or co*i> the invesKM- had he or *he U5cd 
it in the real world in lln- 



Stanin^ with a hlMorical ifuoie flic for the issue of interest and 
a NlTiilc^) ^ivcilJcd h> die user. Stttitrxf^f goes througli ihc tiic 
makinfi rraliMic simiiltted inidcK to see how much the stmlegy 
would ha\e paid in real life. 11>en. siailin^ wuh ihc user's ini 
tial straieg>. the program goes ihrougli the hiMorical hie o\cr 
and over, varying ihc stretcgv slighilv c;Kh time, until il 
arrives at a strateg) thai jpves the optunal pa>off. 



StrarrKi\r uses ;i hi^hlow iiadjng ^>sie«i. cntuiKCd b) the uw 

of persistence checks to confirm buy attd sell signals .ind 
cxponcnnal aven^ECsof i|uoiC'io-quoic volaulny torrkHJif) Hie 
pcr^iMcncc iilundafds and die bu> and sell trigger sensiiivitic&. 

.Sr/'(i/fflfr cos|\ \l'tM^ L S, which includes the main pro^aJii 
and two stippon pnr^grams: one creaiet historical files and the 
oiher 1^Kk^ viivk-io-week price jcttsit> un ihe prcsenil ti»r 
Uadmg sigiiaK The |Mckagc also includes a tetcwoiniminica- 
lions program, a seL|iJcniial file reader and several >LMT^ ot hiv- 
loncal L|uotc?i for a fictional iiiMirancc company, llic program 
runs in compiled basit and is not copy- protected. Stralcgy 
.Si>flwaiV, Bon l4-:4tK^ AnJioMgc. Alaska W? |4, LSvV 

TrmihU'\hooiirtg aritt Rriuunn): the Coinm*»dorw I2S: TAB 
Books hiL. Ix4s annouitced the pubhcaiion of TrouMr^rotinft 
atxd Rrptiirin^ ihr Ctimmtidorr !2>i b> Art Marijolis. 

The book tnchidrs a complcie set of di^nmiic pmgrnms thai 
reailen can use lo icm their own niaLhincN. pAcry one of ifK 
CI28\ chip^ ift detoiicd m a KCpomle chan diat shows the chip 

logic, ptnoutl, and voltage 'fcopc n-adm-is Mjtv^^oIis also 
dcM.Tibc^ tiow lo lake the machuic a^m ajid ic^vicmbk il salcl>, 
and pmvkies the latest chip ch«|gin( Ic^hniques. Included arc a 
vital chip kK;UK»n gujdc and maMcr wlicnulic ot the CI2K. 

The GonMHi abo induile chapters on: test pomis; servicing 
ihc logic gates: itcrvicing digital rcgisiers: the PLA chip; tlic 
nanory managemcm unil: the addrcsv. data and control husrs: 
the 1S563 video contrullen and die power supply. 



The boc^ \m 448 p^ea Md 24(1 illusir^tumx. c\k| ia $24,50 
Can. lSI8,60 US) for die paperback edition and S36.50 Can. 
($27-93 US) for the h,ird cover \ersu»n. TAB B*K»ks. \\k.. Blue 
Ridge Sumiuil. FA 17294-0850. USA, 

1581 loolkil; According lo SoflwaiC Suppon Interoational, 
it took nearly 12 month* to produce ihe }5HI To4ttkit. Tlic 
package includo ihc N*llo\Mn^ features lor the I5KI user: 
fa^ data copier: track and sector editor: b>te pattern 
searcher, file track and sector tracer; relocatable fast loader 
laM lUc Lopicr: directory editor; error scanner; l«M lormat- 
ten partition creator and a ISHI DOS Refer^ntf Cuhic. 
The documentation is in a thrce-fing binder. Software Sup* 
pen Inlemutional, 2700 N.E. Andersen Rd., ffA>l. ^ncou- 
vcrWA986AI, USA- 
Income ta?i prt'paratinn: Master Soflwarc announces the 
^t■ll^t^e of Ilk- M'SH version of tax \fa-\trr, which aids in the 
prejurjiiiKi of US federal income taxes. The program is for the 
CM. viiili either a %\n^k disk drive, a dual disk dnve, or two 
kuiglc duk dnves. A iKinier is optional. 
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fax Master i9fUi coven all ihc new tax taw?t. and guides the 
uvrr rhn»uph ihc pnrpjraiion of Tunns HWO and 4562 Ulcpa-- 
ujlionft. iinJ Schedules A thji>u^h I-. U oIhi includev ihc ux 
uMc^. fiptifci lax lutommtcaMy. pcff<>nn\ ;ill tjk-ulalmn'^, ^nd 
translcr* results fnnn CMic tJ\ lomi lo amuhcr 

nil If^iurr /9M include* ft buiUin calculator funclion ihul 
QUI he acccucd al an> puini in the prugnun. The cukubior 
rc\uft\ can he imnsfoned directly to ihc line of ihc ld\ form 
heing worked u|x>n, Tlic program rcLuh lor S32 US and 
liu ludos a coupon ^iaid to he pood for n vuhstanTlaf di^ouni on 
i\K IUN*> vcrxKm, Masicr Software, ft HiIIlxs t ourt, kandjIU 
siown. MD2II33.USA- 

hLOS 13s, ixnion 2M: Bcriclc> Sullttoika aiukjunce^ vcr- 
itnn 2.0 of (he 0128'^ graphic opcraiin); envmrnmenL Ii 
irKludes enhanced versions o\ ilt'\kli'/f. ^voPomt. DeskAites- 
^•'rffA and diskTurhiK Some of the new features include 
siniihiny ,inil \t.ilinj' of inu^o\. coiisiruin und moa.%ua' Ux*K 
jiid new prupfiu \lupc-* lor ^eoPamt\ Mippon for two driven 
(1541. I57i or I^Kh iind HAM e\p;invion unii. nuiliiplc Hie 
sclctiurti and voUnir ^odin^ of filcN in JcsUopi and cut and 
(UMc optKHU and auiomatic opcnmj of the Hrvt photo album 
on di'.k tor ihc lh\k AttcsMtrifs. 



GEOS I2H 2.0 also includes scvotf 



• feoWrite Workshop I2H tf a word processor thai Tt ^fim-s: 
individual paragraph fonMllm^. Icli, n^hi, tcnirc and full 

juslification: headers and footer^: decimal tab*; full page 
preview: 1 1 fonts in sc^cn s|)lc%and niulnplc m/c\; mixing 
of text and graphics: ^u(^n for multiple columns, head- 
lini?\ ;*nd N>nlfrs: and PtMScnpi oiiiput n> ihc Apple Lnaser- 
WnkT 

• xetiSpcii 128 operates in 80 columns and permits viewing 

of diciionaries and Jocumcnis while checking spelling. It 
allow\ ihc creation and updating of personal dictionaiies 
and supports global search and replace; 

• Icxt Grabber lcL> the umm import lexi Irom any Com- 
mndore word pmceuor 

• gnAtetiie pni\ idcs mail merge ^.apabiliiy 

Uniil April 15. 1989. GEOS I2H 2J> b a\aih»hlc ;o re^isiered 
u^T^ of GEOS t2H fur SJS US. plu^ $4.50 US ^ip[>ing and 
handling (add S2.45 sali-N \a\ if in Califomia*. from Berkeley 
S*»h\\orks i-ulldimcni ( ciuci. 5334 Slerhng Center Drive, 
ttcsilake Village. CA9136L USA, 

(ienraknEJcal viflware: QuinsepI Inc. has created a line of 
genealogical M»ltwan: for the CM: 

• Linea^fsfStaner tc%% the user store data for up to 570 peo- 
ple, prmr alphabetic lis|\ m a \arjciy ol ways, and pnni 
deHxndant chans and ihirc kinds of ai>ceslor charts on a 
Oxnm*Hlorc pnnier 

• Ui$eaxesiSiaiHiafJ duci cver> thing fcxind in Un* 
eojtes/Shirtfr and addi croaa-rrfcrcncmg and priming of 
jddruss labels, and intonuaUon slkrcti showmg wluil is 



rtond fbr each pervm. 

• Umai:f\ \ihtinteii pcnnits the use of alinost any printer 
and up lo four disk drive*. The itter can customize the pro- 
gram, hw example, lo have it al\\ a\ s prini lasl naiiK Ursi, or 
to add an occupauoa. It can do seaahes in a number tU 
ways. A small buih-in word pnvessor pemiiis ihe addition 
ol ^lo^les lo caLh pcrsim's daU Ihu \erMon also cunics 
with telephone ainl mail support. 

• Famtty ff<iots adds many more capabilities to the Lin- 
eages/ AiivameJ prpgnim. including the use of function 
keys for gurck cnir> of repeitlive place names ot sumanies, 
tracing i^\ a new line ol relations on titc M:iccn and Mroding 
only tfKMe you wish to the printer: making a dian ihowing 
only the fathers Imc: and mi on, this program \% al?m 
available for the C12K in its native mode. 

• Tree Cluiin is a supfrienienial program to K>ili Lnwaan 
and fatruiy HimjIa enabling the uacr lo create and prim a 
graphical rrprrsemationof the family tree. 

Quinsept Inc can be reached at Box 216. Letington. MA 
02173, USA. Telephone <M7| MI-2930. Quinsept is repre- 
sented ui Canada b> Generation Press Inc.. 172 King Hcnry\ 
Boulevard.AiiD00Uft,ON MIT 2V6. Tel. UI6) 292 9X45. 



New CI2« CP/M distributor: Poseidon Fleclronics of New 
Vork. NY has been appointed primary IS disinbuior of the 
line of C128 CP/M soliwarc fn>m ileme Data Systems of 
Toronto, ON. Pr>seidon is well-known for its disirihuiion i>f 
CwinHxiore »j>ccirK: CP/M sotlwaie aikl will initially handle 
two Heme Data products JUGG'LEftl2S. \crsjon 3.4, ami 
QPhk, version 2. 1 . The tomicr program is a disk uulity fur the 
IS7I arul 15X1 that allows them to read, write and format over 
141) types of 5 1/4 and 3 1/2 CP/M disks, llic taller is a 
mcnxw) -resident device driver that prt>vide% CP/M nuxk sop- 
pi>n for the Qui*-*- Brown Bok, a hattcr> kuked cMos ham 
eannd^e ilui operates as a non-volaiilc KA\t disk dn\c. Posei- 
don Elecironjcs, 103 Wkveriy Place, New YoA. NY KKMI, 
USA. Telephone (212) 777-9515, 

Basic 8 returns! Free Spirit Sofiv^are Inc, has niiKxIuced sev- 
eral producu for the CI2ti and CM, including a new|y< 
enhanced version of fl^i^V S, which adds oscr 50 graphic com- 
mands lii h ASIC 7.0. Several preprogram nu:d Uusu iS applica- 
tions are included: Hasit Faim. Write and Cafe, Free Spirit is 
alsti otTcrinj; a Ba\tc S Ttntlka fealunng a pi»int and click oper- 
ating syMcm that lets users create tnisiom pointer fonts, pitt- 
terns ami icon». The lim/hi n\\o allows th^* user lo coinen 
Fnm Siutp graphics mio Basil- S graphics filc^, and provide* a 
number of disk uttfities that include make autobooi, eonverl 
icon hie lo brush tile, s^rakh file, rename file, toggle dri%c 
and so iHi. Bask JS ha& a suggoled n:tail price of S39,95 US: 
Ihe hH»IUt is available for SI9>*5. 

Also available: 

• Sketchpad I2H provider free-hand drawing on a MO \ 200 
screen, wiih numcntus drawing U|>s and fonts. Output is 
compaublc with Ham; £, Pnni Shop, News Maker US and 
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Specrnm 12K \*nce H S29.95 US. 

Nf}%-§ Mukfr I2H n i dcNkiop puNishiiif program for 
ncwslcticn^. reports. Kign^ and postcn. Ii u«c« Mamlard 
M.'quonii,il nicv for 'r^>uring' Icxt into uscr-^fincd colum- 
ns FuU pa^ Uyouu popJown mcnu&, uiiuoth M;reen 
*cn>!!in<r, font \oleciion, cut, pasie, minor and flip arc 

arming itK- opli4i[isa% jiIjI^Il- Tcisl \s S2^-S*5 US, 
Sprantm 128 H « menu-operated paint program for ihc 
C128D Uvii can display Uic 1f> ^Mrtdaid colours unil an 
addiiKmal I2H oilours thnm^h coknir diUicrin^ on a MO x 
200 screen, lis fcJtiirLv include air bruvh. craic. minor. 
niuUuukiuL hkvk fill or eniM:. pixcJ cUtlof, coliHu cUitOT, 
fonts, ^lide ^how and othcn. Ii rtqiiirr^ the 1351 or com- 

palibic mouse and cosK S3^>,W- 



Landmark TCRB w nof copy prmected and can he backed up 
ID I58K, U-.l.i; drives such as the SR) HUM of loa lunl ilivL, 
BuiM mode h u^cd with 1571 and 1581 drivct. The \pccd of 
any ?bean:h is cniircls dependent on iIk' speed ol iTk- disk drive 

UNcd. Coinmcn:uLl di^ ^Medup producl^ uiU wufi Ufilh 
Landm^fl fl^oad and search fifes on one side of a disk' stivk 
1541 .6:l)()iiim.;w/Epy3ifaj//jMt/- l:^Smin.). 

l^indtiiark will alttm yiui lo extract infi^niuirion toCfCaieycav 
ovku loptcal fiJev These can be manipulated with landmark's 
own cditinL' features or vou can use ihc Fitr Converifr to 
cxpon liles dial can be u»cd wiUi i'tipcnhp. tt4i\ Siripi, 
vroWHfr Iv2) or Ftm System. I-andmar*; is written in 100^ 
ML ioT speed. Fully nKnu-drivcn for case ot u*c. 






Free Spirit has jNo intnxJuced Mtme CM pixidiiCls. including 
four jfmptucs prugninu which hawc been liccik^^ed fn>m Sulu- 
lioiis Unlimited, Inc.: Iron Fat^rory- is a j^Riphics conversion 
utilu) tS.*4»5 IS): Sirecn f A is .i vlideshiiw cnration and 
presenlalion pntgram (S34.95 US>; Biffhtmni Maker lakes 
fn^^ics from inn\i draw in]£ prc^nms and c^>iiv ens them u> 4- 
fL X 3-ft. sigiu ($34.95 US); and Fhoio Fituiii optinu/es the 
clariiv of the printetl image (WO \ 400 resc^lmion - $29.95 
US)/ 

ESF Ttitrr lS24.*>5 US) m>w irKludes a version ihat will run 
on the C64. The program is !giid lo use the mcUuxIs developed 
b% Dr, J. B. Rhine and the Foundalion Tor Research itn ihe 
Ntture of Man lu teM tor clairvoyance. precogmtuHi ojid 
telepathy, 

MACH tManriivfrahie Armed Computer Humans^ is an 
aKMdc-slylc, sbooi'em-up game for the C64 that fcatun-s *'ihe 
ultimate warrKV ol the tuiure" tS24.^5 US). Order Irom: Free 
Spirit Software Inc.. P.O. Box I2». Kiit/town, PA 19530. 
USA. TeicptHKK (2IS) 683-5609. 

(luitar chord ear training:: Chorti Printer is a JiuionSfy Of 
guitar chord fingerings for ihc CM containing 19 of the TnoH* 
uscd chord types in popular music. Users can team ihc chord 
fonnuliL^ lur each type and tlicir MHUkd by lutcnin^ lo the Cb4 
play them as arpeggios. Other options include utilities for 
pnnlmg hard copies of suii pajvr. uhlaiure paper, blank Ilsc 
frei diagrams and rotH-mxle lisling^ for the fourth, fifth and 
sixth sirin^s, ChtfrJ f'nnter is available ai act>si of SI9»5 I S 

from Cooipuiers. Etc!. Dcpt. GCP, 4521-A Bee Ridge Rd.. 
Sansola,FL342.U USA, Tclepbonc (813) 377-1 i:i or <R00> 

634-5546 lordcii, only). 

Kln^ .lami's Bible on <'fi4 I^uhhuiri. thtr Ct>mptinr Rt'fer^ 
ettce Bihie conMsu oi ihc entire King James version ol the 
Bible on 24 douNe-sitk.'d disks. Hie (At/uirrutrk software pn»- 

vidc^ acvCM to Uic di»k^, witli uidi^iduid vctm; nrlcrcncca amJ 
the words of Oirist hi^hltphted in eol*Mir A concofdaoce of 

over 3, vtKi ol (he most Ircituentlv liHikcd lor words is j}s4» pro- 
vided on six double-sided disks. The program enables the user 
to. for example. cR'ate a fX*rsonal Hible. complele ^^ith noles, 
cnnmeiu&, referencing aiul ouilinmg of lexl. 



Cost is $119,95 US. PAVY Software. RO, B4>x 15S4, Rallwin. 
MO 63022. USA. 

Free M>riware frum Memorex. Mcmnn'x has esiahhshed a 

'fre(|uem buyer' pro gra m that \€i% cusiomerx build points 
toward free software. Titles available iiKludc the PFS scncs 
frum Software Publishing Corp., and others from Accolade, 
\ctivisi(tn Disk-C<Hinl Software. Ekctnmic Anv Individual 
and Publi-^hiii^ litunuuonal iBjteSt/ej, The program pny 
motc^ the full line of Memorex computer supplies. itKluding 

disks and paper. Insliuclions and a conipleit' list of available 
sullwaK an: on each package, Memorex Computer Supplies, 
2400 Condcn*a Si.. SmU Clara, CA 9505 1 4)996, USA Tele 
phiine(4(Wi957-l(J00. 



WE WONT PAY YOUn TAXESI 







A. a e, D. fl s p. 



• £MV eHANOI ot v^ 

• TMAMSFtaS 
'CALCULATE! ftHf 
> SiVCS «i vcw MM Id 

• Pf«NTS Ch* Mtt 

• CALCULAfOa 
'MSCOUMT 

TAX MASTEA 



■K) Rf f UNO tai uttm an 



aac** *o™* 



of ritut 

(ON DtSK] 



ONLY $32.00 



TIRED OF SWITCHING CABLES? 



lift D^M iw^iM u itf to cmmt^ oov inoan, a> 
VDiO MASTER laa for Cemmotfora tM... 



FED UP WITH SYNTAX ERRORS? 






HELP MASTER 04 



Commodorv A4 , MC .... S24 99 



OTHER MASTER SOFTWARE ITEMS 



nnST MM Tin C-«4 vnt ft«C| 
CMP SMTCn WT 

motxM tumnm ij»r pom 

T-NOTt frtm wvi V aVm i 
T ViSI «tool mttm T ctt/m ) 
C-iJ ><Octf 

•A-T1UM Thaortr 



SMJS 

S,» 

IftJt 

is^oi 



d#nrf f^ ff90 CMatog 



MAQTER 

lOFTWARE 

e Htll«ry Cf. 
Rondaiifttown. MD 2I1» 

(301)922-2962 




Tiortsoctor 



Apiat9«9;Volum«9. 




FINAL CARTRIDGE HI® 

The Best Utility Ever for Your C-64 or 128 



Only! 

SPECIAI- VAIXTE: 

Tina! Retail Value, 

Tlii-t piiwrrful ROM-ImmhI tttM-ratinft 
syniem cdnt.un^ *-iL\v-t*m?*»' wmilurtN 
and pull doun mvnus. Allfiwinj< lUv 

IIMT In s*'Utl rUhrr IIMHIM'. j«i>MKic 

or ke> buanl, he may acitVH uwr (iU 
114-w <^>mmiuids And nimtlf^ret. Li^ 
ytHiri -tvt petfnnn liki- un Ami^^^i. 
VuhoiiK prinlrr mtrrfiu i-^ .i^ w^'ll iL^ a 

tio^v tiHilkn tan ifcU* in- Mtt_1^^*^^. 
ErrcNMD ML MoNrron 

Ik*-*. INK n*-iMk' U\ ITH jn'»i>' llH.lLKk« IMI 

drtvr aopBw wid ^rtlc oUUntf. ItaUirM 
uf> and dnwn wmnnir anri prim«T drlwr! 



$69.95 



Oinritirt^ I im| » >n n iruil rhjfcraitvni and 



Fmtmt Dnk LoAOiHa Evin! 

16x taMer Ihan noniuJf 
TRju«vonM YouM C-M llffO 



Vartnui wtnikmn mdi mk fV pfwgnce * , 
TkiKv t>i>J( Wlnchtw^ Dlrrctor>'. IVintrr A 
1'kii h aUi>H >'<Hi X*' Swi as If yuu an* 
wcirkiim in thf lUm' fnt-ikli^ i^itMniiuiu^iii 
akUie Anuria! 

KaavTO'Uaa Maxu &aji 

AtimkflC any cummanfl ncit arlivatMl by 
Hln(lftv»-4 ran be accMBrd whHr kn Bulr 



kill ^ivr, Jlk KAM fur Lkun., fu^ ronnat 
^Kt nMio- nuuo' nH>rv. 

. .tranfhfgin Ht think tf^ rarfH/ttrr 
v-Airh <iv^ .«> rHfinff luv^'uf things . .a tr^ 
m^mitmn tfolur. a muM itt^n ft/r (kr liA- 

—An llunkUM. C^omiMiu- > Uatt.-Uv 7.117 



Only! 

;E .loystlolc and FREE 100 PARAMETER PAK, 
.95, with each punha.se FINAL CAKIKIDGE Ul 

IntroducTngsuper 

till k-^ u|i Mty "Mifiwiiri^ j>ri|iniirr 
E\'en the laK-M |>n>io(tiun adwmot! 
i'li^p into your drive with otdy Ow 
it«' nr :i M'n-wclnvi-r. If anylliinfC 
oHilcl li;ii k lip «-vrr\'i)iJni£. lias i\ it. 
liNt'n S4lll^^■u~llr'r1 ^iianuiltH.<il^ lUiLi^ 
i»r luont-y buk giumnUe! 

ONLY $39.95! 



•vm or T>«i Airt Fi 

liK luili-% v.iruiMi- Mji ' : r^-n ihiiap« (orfitr 
If tlpnun t^vtr^r <tf NtX^ b itm.\il Alkiwi to- 
tal badnip of any mrmcry midMl Kift- 
warr on th<' miirirt Uiday? Pltr^ aiv 
parked and retoadaMe huH'-mi ihr rar^ 
thdiBiV 4MJK tnJiM if> w^nuwlfi. I^ihs 1q 

bMlcorllL 




FINAL CARTRIDGE II 

ONLY S24,95 

Call or write for more intormatton 



KIBi ^rtie lo nprtte and^or backffnund 
CoMUon. Cm bv Mju1i*iI nl uny i*4nt in 

AvToFim Ehgum 

l^amfonna nonnat joyatirk inin an am n 

ar«buutml1 Wowll 

CkK . Jhh ai u pruv im a rarity, " 

-Tim WaWi, RITN M:i«>^iir fl1(7 



C#MP • » Uw vHinitfr nrt*i^ 14 ' 

I 
MrikUiiO. BulonfiHAf ami 
Wi«kB ivrfKll) >llh n.* riMf c dftn^ir I yv^ 



mn ij7« " * ,, 

Mft iivi^ 




OF AMERICA 

IM Valley Sin^-l 

Suulh Oraiv. NJ 07079 

30l'76S-aW6, dtriwi only. 2U1 763-1603 



EXTRAS AVAtLABLE 

'tnnal Caririd0t> i 114.95 

•C-|:ifil Misuse $:tl.^f> 

iVIuxr Jnysnrk S H.95 

cabie' luiJiKHiaJ) $I9H5 

Ordering Info: 

Ordafa Only Cati: 

1 aoo-iHww _ 

HJ •■•Mrti «M wre^rtia Mm tM Md U 00 to ii*« 
t>^#*ani a^ nto ctf 

ANY PRODUCT PURCHASED FROM 
DATEL ELECTRONICS WILL NOT 
BE GUARANTEED BY H&P 
COMPUTER. 



"..^xctltM^ tfRdenl prtjrtm tfiil c«n hcfp you tive twtti 

mone> tni downirmi." Compute!'! G«»ttt 

1541 f57f OtC., 19S7 

DfWEAUGNMENf 

1541/1571 Ortvf AMgnmanl nports the alignment conctt^ 
lion of ttio disk drive as yon ptrlonn atfjustmenb. On 
screen Mp is available wrule the program is running in- 
cHides features lor speed adiustment Complete instruction 
manual on aligning twtti 1541 and 1571 drives Even mi- 
chides instructions on tnm to load alignment program «hen 
nothing else will foad^ Works on ine C64. SX64. CI 28 m 
either 64 or 1?8 mode, 1541. 1571 ir either 1541 or 
1571 mode* Auiotx>ots to all modes. Second drive lulfy 
supported Program disk, calibration disk and instruction 
manual included. 

rsted rttal prtce $34.95 



*vJL'i» 




''uTT^- 



Super 81 Utilities is a complete utJliiies packegt lor the 

1581 disk drive. Separate version are available lor C64 or 

C128 An org the many Super 81 Utilities features are: 

•Cop/ whoe disks Irom t541 or 1571 lormat to 1581 

partjiions 

•Copy 1541 or 1571 lltes to 1581 disks 

•Biickup 1581 disks or files with 1 or 2 158rs 

•SuppMd on bath 3V/ and 5' « diskettes so that it will 

load on a 1541. 1571 or 1581 dnve 

•Performs numerous DOS functions such as rename a disk. 

rename a Me, scratch or unscratcti t^ies, Uxk or untock 

Mes. create auto boot and much more! 

Staler 81 Utilrties uses an option window to display an 

choices avtfable at any given time, A full featured disk 

utilities system tor the 1581* 

tuggetM rvttf price $39.95 

Home Designer 

Gwen ohnvmg la: tjy every major Commodore 

magazine, this CAD system oulclasser every other CAO 
program, because of its obiect based design With over 50 
powerlul commends. 5 drawing layers, superb support of 
library figures and la^er quality printouts at A^Y scale on 
your dot matrix printer or plotter, you can create drawings 
so accurate that a bfueprtnt can be made from them! Tired 
of working with poor quality/maccurate prmtouts. 
manipulating little dots on a bit map, giving up on detailed 
work because you cant foom in close enough? Jotn the 

professmniM! 

SuBBCtted retail p'-ce S49.9S 



^ 



Skeichpad 126 ^ 

Complete drdwing system for the Cor 
1351 Mouse, Sketchpad 1 28 takes advantage of the crttp 
80 column graphics capabilities of the CI 28 Smooth 
freehand drawing. 640 x 200 drawing screen, wide 
selection of dawmg tips, many fonts provided Compairble 
with Basic B. Pnnt Shop, News Maker 128 and Spectrum 
128 Sketchpad 128 can be used to create 80 column 
aMwork, sWeshows. ygns. posters and many oltier uses 

Suggested relaH price S29.95 




^^ 




Itowi Maker 128 ' - L^^ "r , ^"l S 

Desk top publishing for the CI 280 (or the CI 28 with 64K 
V>deo Ram Upgrade) News Maker 128 can be used to 
creale professional looking newsletters, reports, sjgns and 
tnsters- li can be used as a stand alone program or m 
combmalion with word processing or graphics software II 
uses standard sequential files for "pouring" text into user 
defined column:: Full page layout, popdown menus, smooth 
screen scrolting. font selection, cut. paste, mirror, flip are 
among the options available 

Sifggested retal price $2«.H 




%ectrum 128 
A deiune paint program for the C12BD computer (or the 
0128 wrih 64K Video RAM Upgrade) Uses 60 column 
display for 640 x 200 pixel resolution WiH display 128 
cokirs! htenu operated Requires 1351 or compatible 
Mou<ie. Features include air brush, erase, mirror, mutti 
cokK, block fill or erase, pixel editor, color editor, fonts, 
slide show and more^ Compatible with Sketchpad 128 
News Maker 128, Base 8. 1750 REU 1541, 1571 and 
158) disk dnves. Suggetied retatf price S39.9S 

Basic 8 

Powerful 80 column hi res graphics programming system 
lor the Commodore 128 or 1280 computer. This popular 
package adds over 50 new graphic commands to standard 
C128 Basic. A must for C128 programmers! This new 
version published by Free Spirit hat been upgraded and 
enhanced. As an adiled bonus several preprogrammed 
Basic 8 applcations. such as Basic Paint, wnie and Calc 

aremcluoed. Sl«ettMretadpnccS39.9S 



See your dealer or order from Free Spml Software. M, 
58 Noble Street 
Kut/town, PA 19530 
215 683 5609 






